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CHAPTER  1 
INTRODUCTION 


This  Validation  Summary  Report  TVSlt)‘^^escribe3  the  extent  to  which  a 
specific  Ada  compiler  conforms  to  the  Ada  Standard,  ANSI/MIL-STD-1815A. 
This  report  explains  all  technical  terms  used  within  it  and  thoroughly 
reports  the  results  of  this  compiler  using  the  Ada  Compiler 
Validation  Capability  i  ^<1kCVCT.  An  Ada  compiler  must  be  implemented 
according  to  the  Ada  Standard,  and  any  implementation-dependent  features 
must  conform  to  the  requirements  of  the  Ada  Standard.  The  Ada  Standard 
must  be  implemented  in  its  entirety,  and  nothing  can  be  implemented  that  is 
not  in  the  Standardly 

Even  though  all  validated  Ada  compilers  conform  to  the  Ada  Standard,  it 
must  be  understood  that  some  differences  do  exist  between  implementations. 
The  Ada  Standard  permits  some  implementation  dependencies~for  example,  the 
maximum  length  of  identifiers  or  the  maximum  values  of  integer  types. 
Other  differences  between  compilers  result  from  the  characteristics  of 
particular  operating  systems,  hardware,  or  implementation  strategies.  All 
the  dependencies  observed  during  the  process  of  testing  this  compiler  are 
given  in  this  report.' 

The  information  in  this  report  is  derived  from  the  test  results  produced 
during  validation  testing.  The  validation  process  includes  submitting  a 
suite  of  standardized  tests,  the  ACVC,  as  inputs  to  an  Ada  compiler  and 
evaluating  the  results .  The  purpose  of  validating  is  to  ensure  conformity 
of  the  compiler  to  the  Ada  Standard  by  testing  that  the  compiler  properly 
implements  legal  language  constructs  and  that  it  identifies  and  rejects 
illegal  language  constructs.  The  testing  also  identifies  behavior  that  is 
implementation-dependent  but  is  permitted  by  the  Ada  Standard.  Six  classes 
of  tests  are  used.  These  tests  are  designed  to  perform  checks  at  compile 
time,  at  link  time,  and  during  execution. 
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1 . 1  PURPOSE  OF  THIS  VALIDATION  SUMMARY  REPORT 


This  VSR  documents  the  results  of  the  validation  testing  performed  on  an 
Ada  compiler.  Testing  was  carried  out  for  the  following  purposes; 

.  To  attempt  to  identify  any  language  constructs  supported  by  the 
compiler  that  do  not  conform  to  the  Ada  Standard 

.  To  attempt  to  identify  any  language  constructs  not  supported  by 
the  compiler  but  required  by  the  Ada  Standard 

.  To  determine  that  the  implementation-dependent  behavior  is  allowed 
by  the  Ada  Standard 

Testing  of  this  compiler  was  conducted  by  SofTech,  Inc.  under  the 
direction  of  the  AVF  according  to  procedures  established  by  the  Ada  Joint 
Program  Office  and  administered  by  the  Ada  Validation  Organization  (AVO). 
On-slte  testing  was  completed  4  May  1989  at  Cupertino  CA. 


1.2  USE  OF  THIS  VALIDATION  SUMMARY  REPORT 

Consistent  with  the  national  laws  of  the  originating  country,  the  AVO  may 
make  full  and  free  public  disclosure  of  this  report.  In  the  United  States, 
this  is  provided  in  accordance  with  the  "Freedom  of  Information  Act"  (5 
D.S.C.#552).  The  results  of  this  validation  apply  only  to  the  computers, 
operating  systems,  and  compiler  versions  identified  in  this  report. 

The  organizations  represented  on  the  signature  page  of  this  report  do  not 
represent  or  warrant  that  all  statements  set  forth  in  this  report  are 
accurate  and  complete,  or  that  the  subject  compiler  has  no  nonconformities 
to  the  Ada  Standard  other  than  those  presented.  Copies  of  this  report  are 
available  to  the  public  from; 

Ada  Information  Clearinghouse 
Ada  Joint  Program  Office 
OUSDRE 

The  Pentagon,  Rm  3D- 139  (Fern  Street) 

Washington  DC  20301-3081 

or  from; 


Ada  Validation  Facility 
ASD/SCEL 

Wright-Patterson  AFB  OH  45433-6503 
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Questions  regarding  this  report  or  the  validation  test  results  should  be 
directed  to  the  AVF  listed  above  or  to : 

Ada  Validation  Organization 
Institute  for  Defense  Analyses 
1801  North  Beauregard  Street 
Alexandria  VA  22311 


1.3  REFERENCES 

1 .  Reference  Manual  for  the  Ada  Prograaming  Language , 
ANSI/MIL-STD-1815A,  February  1983  and  ISO  8652-1987. 

2.  Ada  Compiler  Validation  Procedures  and  Guidelines ,  Ada  Joint 
Program  Office,  1  January  1987. 

3.  Ada  Compiler  Validation  Capability  Implementers '  Guide,  SofTech, 
Inc.,  December  1986. 

4.  Ada  Compiler  Validation  Capability  User *3  Guide ,  December  1986. 


1.4  DEFINITION  OF  TERMS 

ACVC  The  Ada  Compiler  Validation  Capability.  The  set  of  Ada 

programs  that  tests  the  conformity  of  an  Ada  compiler  to  the 
Ada  programming  language . 

Ada  An  Ada  Commentary  contains  all  information  relevant  to  the 

Commentary  point  addressed  by  a  comment  on  the  Ada  Standard.  These 

comments  are  given  a  unique  identification  number  having  the 
form  Al-ddddd . 

Ada  Standard  ANSI/MIL-STD-1815A,  February  1983  and  ISO  8652-1987. 

Applicant  The  agency  requesting  validation. 

AVF  The  Ada  Validation  Facility.  The  AVF  is  responsible  for 

conducting  compiler  validations  according  to  procedures 
contained  in  the  Ada  Compiler  Validation  Procedures  and 
Guidelines. 

AVO  The  Ada  Validation  Organization.  The  AVO  has  oversight 

authority  over  all  AVF  practices  for  the  purpose  of 
maintaining  a  uniform  process  for  validation  of  Ada 
compilers.  The  AVO  provides  administrative  and  technical 
support  for  Ada  validations  to  ensure  consistent  practices. 

Compiler  A  processor  for  the  Ada  language.  In  the  context  of  this 

report,  a  compiler  is  any  language  processor,  including 
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cross-compilers,  translators,  and  interpreters. 

Failed  test  An  ACVC  test  for  which  the  compiler  generates  a  result  that 
demonstrates  nonconformity  to  the  Ada  Standard. 

Host  The  computer  on  which  the  compiler  resides. 

Inapplicable  An  ACVC  test  that  uses  features  of  the  language  that  a 

test  compiler  is  not  required  to  support  or  may  legitimately 

support  in  a  way  other  than  the  one  expected  by  the  test. 

Passed  test  An  ACVC  test  for  which  a  compiler  generates  the  expected 
result. 

Target  The  computer  for  which  a  compiler  generates  code. 

Test  A  program  that  checks  a  compiler's  conformity  regarding  a 

particular  feature  or  a  combination  of  features  to  the  Ada 
Standard.  In  the  context  of  this  report,  the  term  is  used  to 
designate  a  single  test,  which  may  comprise  one  or  more 
files . 

An  ACVC  test  found  to  be  incorrect  and  not  used  to  cheek 
conformity  to  the  Ada  Standard.  A  test  may  be  incorrect 
because  it  has  an  invalid  test  objective ,  fails  to  meet  its 
test  objective,  or  contains  illegal  or  erroneous  use  of  the 
language . 


1.5  ACVC  TEST  CLASSES 

Conformity  to  the  Ada  Standard  is  measured  using  the  ACVC.  The  ACVC 
contains  both  legal  and  illegal  Ada  programs  structured  into  six  test 
classes;  A,  B,  C,  D,  E,  and  L.  The  first  letter  of  a  test  name  identifies 
the  class  to  which  it  belongs.  Class  A,  C,  D,  and  E  tests  are  executable, 
and  special  program  units  are  used  to  report  their  results  during 
execution.  Class  3  tests  are  expected  to  produce  compilation  errors. 
Class  L  tests  are  expected  to  produce  compilation  or  link  errors  because  of 
the  way  in  which  a  program  library  is  used  at  link  time. 

Class  A  tests  ensure  the  successful  compilation  of  legal  Ada  programs  with 
certain  language  constructs  which  cannot  be  verified  at  compile  time. 
There  are  no  explicit  program  components  in  a  Class  A  test  to  check 
semantics.  For  example,  a  Class  A  test  checks  that  reserved  words  of 
another  language  (other  than  those  already  reserved  in  the  Ada  language) 
are  not  treated  as  reserved  words  by  an  Ada  compiler.  A  Class  A  test  is 
passed  if  no  errors  are  detected  at  compile  time  and  the  program  executes 
to  produce  a  PASSED  message. 

Class  B  tests  check  that  a  compiler  detects  illegal  language  usage.  Class 
B  tests  are  not  executable.  Each  test  in  this  class  is  compiled  and  the 
resulting  compilation  listing  is  examined  to  verify  that  every  syntax  or 
semantic  error  in  the  test  is  detected.  A  Class  B  test  is  passed  if  every 


Withdrawn 

test 
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illegal  construct  that  it  contains  is  detected  by  the  compiler. 

Class  C  tests  check  the  run  time  system  to  ensure  that  legal  Ada  programs 
can  be  correctly  compiled  and  executed.  Each  Class  C  test  is  self-checking 
and  produces  a  PASSED,  FAILED,  or  NOT  APPLICABLE  message  indicating  the 
result  when  it  is  executed. 

Class  D  tests  check  the  compilation  and  execution  capacities  of  a  compiler. 
Since  there  are  no  capacity  requirements  placed  on  a  compiler  by  the  Ada 
Standard  for  some  parameters — for  example,  the  number  of  identifiers 
permitted  in  a  compilation  or  the  number  of  units  in  a  library — a  compiler 
may  refuse  to  compile  a  Class  D  test  and  still  be  a  conforming  compiler. 
Therefore,  if  a  Class  D  test  fails  to  compile  because  the  capacity  of  the 
compiler  is  exceeded,  the  test  is  cleissified  as  Inapplicable.  If  a  Class  D 
test  compiles  successfully,  it  is  self-checking  and  produces  a  PASSED  or 
FAILED  message  during  execution. 

Class  E  tests  are  expected  to  execute  successfully  and  check 
implementation-dependent  options  and  resolutions  of  ambiguities  in  the  Ada 
Standard.  Each  Class  E  test  is  self-checking  and  produces  a  NOT 
APPLICABLE,  PASSED,  or  FAILED  message  when  it  is  compiled  and  executed. 
However,  the  Ada  Standard  permits  an  implementation  to  reject  programs 
containing  some  features  addressed  by  Class  E  tests  during  compilation. 
Therefore,  a  Class  E  test  is  passed  by  a  compiler  if  it  is  compiled 
successfully  and  executes  to  produce  a  PASSED  message,  or  if  it  is  rejected 
by  the  compiler  for  an  allowable  reason. 

Class  L  tests  check  that  incomplete  or  illegal  Ada  programs  involving 
multiple,  separately  compiled  units  are  detected  and  not  allowed  to 
execute.  Class  L  tests  are  compiled  separately  and  execution  is  attempted. 
A  Class  L  test  passes  if  it  is  rejected  at  link  time — that  is ,  an  attempt 
to  execute  the  main  program  must  generate  an  error  message  before  any 
declarations  in  the  main  program  or  any  units  referenced  by  the  main 
program  are  elaborated.  In  some  cases,  an  implementation  may  legitimately 
detect  errors  during  compilation  of  the  test. 

T-fio  library  units,  the  package  REPORT  and  the  procedure  CHECK_FILE,  support 
the  self-checking  features  of  the  executable  tests.  The  package  REPORT 
provides  the  mechanism  by  which  executable  tests  report  PASSED,  FAILED,  or 
NOT  APPLICABLE  results.  It  also  provides  a  set  of  identity  functions  used 
to  defeat  some  compiler  optimizations  allowed  by  the  Ada  Standard  that 
would  circumvent  a  test  objective.  The  procedure  CHECK_FILE  is  used  to 
check  the  contents  of  text  files  written  by  some  of  the  Class  C  tests  for 
chapter  14  of  the  Ada  Standard.  The  operation  of  REPORT  and  CHECK_FILE  is 
checked  by  a  set  of  executable  tests.  These  tests  produce  messages  that 
are  examined  to  verify  that  the  units  are  operating  correctly.  If  these 
units  are  not  operating  correctly,  then  the  validation  is  not  attempted. 

The  text  of  each  test  in  the  ACVC  follows  conventions  that  are  intended  to 
ensure  that  the  tests  are  reasonably  portable  without  modification.  For 
example,  the  tests  make  use  of  only  the  basic  set  of  55  characters,  contain 
lines  with  a  maximum  length  of  72  characters,  use  small  numeric  values,  and 
place  features  that  may  not  be  supported  by  all  implementations  in  separate 
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tests.  However,  some  tests  contain  values  that  require  the  test  to  be 
customized  according  to  implementation-specific  values— for  example,  an 
illegal  file  name.  A  list  of  the  values  used  for  this  validation  is 
provided  in  Appendix  C. 

A  compiler  must  correctly  process  each  of  the  tests  in  the  suite  and 
demonstrate  conformity  to  the  Ada  Standard  by  either  meeting  the  pass 
criteria  given  for  the  test  or  by  showing  that  the  test  is  inapplicable  to 
the  implementation.  The  applicability  of  a  test  to  an  implementation  is 
considered  each  time  the  implementation  is  validated.  A  test  that  is 
inapplicable  for  one  validation  is  not  necessarily  inapplicable  for  a 
subsequent  validation.  Any  test  that  was  determined  to  contain  an  illegal 
language  construct  or  an  erroneous  language  construct  is  withdrawn  from  the 
ACVC  and,  therefore,  is  not  used  in  testing  a  compiler.  The  tests 
withdrawn  at  the  time  of  this  validation  are  given  in  Appendix  D. 
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CONFIGURATION  INFORMATION 


2.1  CONFIGURATION  TESTED 

The  candidate  compilation  system  for  this  validation  was  tested  under  the 
following  configuration! 

Compiler:  HP  9000  Series  300  Ada  Compiler,  Version  ^.35 
ACVC  Version:  1.10 


Certificate  Number:  89050^1 

.10079 

Host  Computer: 

Machine: 

HP  9000 

Series  300  Model  370 

Operating  System: 

HP-UX 

Version 

6.5 

Memory  Size: 

16  Mb 

Target  Computer: 


Machine : 

HP  9000 

Series  300  Model  370 

Operating  System: 

HP-UX 

Version 

6.5 

Memory  Size: 

16  Mb 
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2.2  IMPLEMENTATION  CHARACTERISTICS 

One  of  the  purposes  of  validating  compilers  is  to  determine  the  behavior  of 
a  compiler  in  those  areas  of  the  Ada  Standard  that  permit  implementations 
to  differ.  Class  D  and  E  tests  specifically  check  for  such  implementation 
differences.  However,  tests  in  other  classes  also  characterize  an 
implementation.  The  tests  demonstrate  the  following  characteristics; 


a.  Capacities. 


(1)  The  compiler  correctly  processes  a  compilation  containing  723 
variables  in  the  same  declarative  part.  (See  test  D29002K.) 

(2)  The  compiler  correctly  processes  tests  containing  loop 
statements  nested  to  65  levels.  (See  tests  D55A03A..H  (9 
tests).) 

(3)  The  compiler  correctly  processes  tests  containing  block 
statements  nested  to  65  levels.  (See  test  D56001B.) 

(4)  The  compiler  correctly  processes  tests  containing  recursive 
procedures  separately  compiled  as  subunits  nested  to  17 
levels.  (See  tests  D64005E. .G  (3  tests).) 


b.  Predefined  types. 

(1)  This  implementation  supports  the  additional  predefined  types 
SHORT_INTEGER,  SHORT_SHORT  INTEGER,  and  L0NG_FL0AT  in  package 
STANDARD.  (See  tests  B8600Tt..Z  (7  tests).) 


c.  Expression  evaluation. 

The  order  in  which  expressions  are  evaluated  and  the  time  at  which 
constraints  are  checked  are  not  defined  by  the  language.  While 
the  ACVC  tests  do  not  specifically  attempt  to  determine  the  order 
of  evaluation  of  expressions,  test  results  indicate  the  following; 

(1)  None  of  the  default  initialization  expressions  for  record 
compononts  are  evaluated  before  any  value  is  checked  for 
membership  in  a  component's  subtype.  (See  test  C32117A.) 

(2)  Assignments  for  subtypes  are  performed  with  the  same  precision 
as  the  base  type.  (See  test  C35712B.) 

(3)  This  implementation  uses  no  extra  bits  for  extra  precision  and 
uses  all  extra  tits  for  extra  range.  (See  test  C35903A. ) 
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(^)  NUMERIC_ERROR  is  raised  when  an  integer  literal  operand  in  a 
comparison  or  membership  test  is  outside  the  range  of  the  base 
type.  (See  test  C45232A.) 

(5)  Sometimes  NUMERIC_ERROR  is  raised  when  a  literal  operand  in  a 
fixed-point  comparison  or  membership  test  is  outside  the  range 
of  the  base  type.  (See  test  C45252A. ) 

(6)  Underflow  is  not  gradual.  (See  tests  C45524A..Z.) 


d.  Rounding. 

The  method  by  which  values  are  rounded  in  type  conversions  is  not 
defined  by  the  langiiage.  While  the  ACVC  tests  do  not  specifically 
attempt  to  determine  the  method  of  rounding,  the  test  results 
indicate  the  following: 

(1)  The  method  used  for  rounding  to  integer  is  round  to  even. 
(See  tests  C46012A. .Z.) 

(2)  The  method  used  for  rounding  to  longest  integer  is  round  to 
even.  (See  tests  C46012A..Z.) 

(3)  The  method  used  for  rounding  to  integer  in  static  universal 
real  expressions  is  round  to  even.  (See  test  C4A014A.) 


e.  Array  types. 

An  implementation  is  allowed  to  raise  NUMERIC^ERROR  or 

CONSTRAINT  ERROR  for  an  array  having  a  'LENGTH  that  exceeds 

STANDARD. INTEGER 'LAST  and/or  SYSTEM. MAX_INT. 

For  this  implementation; 

(1)  Declaration  of  an  array  type  or  subtype  declaration  with  more 
than  SYSTEM. MAX_INT  components  raises  NUMERIC_SRROR.  (See 
test  C36003A.) 

(2)  NUMERIC_ERROR  is  raised  when  a  null  array  type  with 

INTEGER'LAST  +  2  components  is  declared.  (See  test  C36202A.) 

(3)  NUMERIC_ERROR  is  raised  when  a  null  array  type  with 

SYSTEM. MAX_INT  +  2  components  is  declared.  (See  test 

C36202B.) 

(4)  A  packed  BOOLEAN  array  having  a  'LENGTH  exceeding  INTEGER'LAST 
raises  NUMERIC  ERROR  when  the  array  type  is  declared.  (See 
test  C52103X.) 
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(5)  A  packed  two-diraensional  BOOLEAN  array  with  more  than 
INTEGER 'LAST  components  raises  NUMERIC_ERROR  when  the  array 
type  is  declared.  (See  test  C52104Y.) 

( 6)  A  null  array  with  one  dimension  of  length  greater  than 

INTEGER 'LAST  may  raise  NUMERIC_ERROR  or  CONSTRAINT_ERROR 
either  when  declared  or  assigned.  Alternatively,  an 

implementation  may  accept  the  declaration.  However,  lengths 
must  match  in  array  slice  assignments.  This  implementation 
raises  NUMERIC  ERROR  when  the  array  type  is  declared.  (See 
test  E52103Y.)  “ 

(7)  In  assigning  one-dimensional  array  types,  the  expression  is 
evaluated  in  its  entirety  before  CONSTRAINT_ERROR  is  raised 
when  checking  whether  the  expression's  subtype  is  compatible 
with  the  target's  subtype.  (See  test  C52013A.) 

(8)  In  assigning  two-dimensional  array  types,  the  expression  is 
not  evaluated  in  its  entirety  before  CONSTRAINT__SRROR  is 
radsed  when  cheeking  whether  the  expression's  subtype  is 
compatible  with  the  target's  subtype.  (See  test  C52013A.) 


f.  Discriminated  types. 

(1)  In  assigning  record  types  with  discriminants,  the  expression 
is  evaluated  in  its  entirety  before  CONSTRAINT__ERROR  is  raised 
when  checking  whether  the  expression's  subtype  is  compatible 
with  the  target's  subtype.  (See  test  C52013A.) 


g.  Aggregates. 

(1)  In  the  evaluat-ion  of  a  multi-dimensional  aggregate,  all 
choices  are  evaluated  before  checking  against  the  index  type. 
(See  tests  CU3207A  and  C4320TB.) 

(2)  In  the  evaluation  of  an  aggregate  containing  subaggregates, 
all  choices  are  evaluated  before  being  checked  for  identical 
bounds.  (See  test  £432128.) 

(3)  CONSTRAINT_ERROR  is  raised  after  all  choices  are  evaluated 
when  a  bound  in  a  non-null  range  of  a  non-null  aggregate  does 
not  belong  to  an  index  subtype.  (See  test  E43211B.) 


h.  Pragmas. 

(1)  The  pragma  INLINE  is  supported  for  functions  and  procedures. 
(See  tests  LA3004A..B,  SA3004C..D,  and  CA3004E. .F.) 
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i.  Generics 

(1)  Generic  specifications  and  bodies  can  be  compiled  in  separate 
compilations.  (See  tests  CA1012A,  CA2009C,  CA2009F,  BC3204C, 
and  BC3205D.) 

(2)  Generic  unit  bodies  and  their  subunits  can  be  compiled  in 
separate  compilations.  (See  test  CA3011A.) 


J .  Input  and  output 

(1)  The  paclage  SEQUENTIAL__IO  can  be  instantiated  with 
unconstrained  array  types  and  record  types  with  discriminants 
without  defaults.  (See  tests  AE2101C,  EE2201D,  and  EE2201E.) 

(2)  The  package  DIRECT__IO  can  be  instantiated  with  unconstrained 
array  types  and  record  types  with  discriminants  without 
defaults.  (See  tests  AE2101H,  EE2401D,  and  EE2401G.) 

(3)  Modes  IN  FILE  and  OUT  FILE  are  supported  for  SEQUENTIAL_IO. 
(See  tests  CE2102D..E,  ci2102N,  and  CE2102P.) 

(4)  Modes  IN  FILE,  OUT  FILE,  and  INOUT  FILE  are  supported  for 
DIRECT  loT  (See  tests  CE2102F,  CE2102I..J,  CE2102R,  CE2102T, 
and  CE2102V.) 

(5)  Modes  IN  FILE  and  OUT_FILE  are  supported  for  text  files.  (See 
tests  CE3102E  and  CE3102I..K.) 

(6)  RESET  and  DELETE  operations  are  supported  for  SEQUENTIAL_IO. 
(See  tests  CE2102G  and  CE2102X.) 

(7)  RESET  and  DELETE  operations  are  supported  for  DIRECT_IO.  (See 
tests  CE2102K  and  CE2102Y.) 

(3)  RESET  and  DELETE  operations  are  supported  for  text  files. 
(See  tests  CE3102F..G,  CE3104C,  CESHOA,  and  CE3114A.) 

(9)  Overwriting  to  a  sequential  file  truncates  to  the  last  element 
written.  (See  test  CE2208B.) 

(10)  Temporary  sequential  files  are  given  names  and  deleted  when 
closed.  (See  test  CE2108A.) 

(11)  Temporary  direct  files  are  given  names  and  deleted  when 
closed.  (See  test  CE2108C.) 

(12)  Temporary  text  files  are  given  names  and  deleted  when  closed. 
(See  test  CE3112A.) 
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(13)  More  than  one  internal  file  can  be  associated  with  each 

external  file  for  sequential  files  when  writing  or  reading. 
(See  tests  CE2107A..E,  CE2102L,  CE2110B,  and  CE2111D.) 

(14)  More  than  one  internal  file  can  be  associated  with  each 

external  file  for  direct  files  when  writing  or  reading.  (See 
tests  CE2  107F..H  (3  tests),  CE2110D,  and  CE2111H.) 

(15)  More  than  one  internal  file  can  be  associated  with  each 

external  file  for  text  files  when  writing  or  reading.  (See 
tests  CE3niA..E,  CE3114B,  and  CE3115A.) 
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3.1  TEST  RESULTS 

Version  1.10  of  the  ACVC  comprises  3717  tests.  When  this  compiler  was 
tested,  U3  tests  had  been  withdrawn  because  of  test  errors.  The  AVF 
determined  that  363  tests  were  inapplicable  to  this  implementation.  All 
inapplicable  tests  were  processed  during  validation  testing  except  for  201 
executable  testa  that  use  floating-point  precision  exceeding  that  supported 
by  the  implementation  .  Modifications  to  the  code,  processing,  or  grading 
for  35  tests  were  required  to  successfully  demonstrate  the  test  objective. 
(See  section  3*6.) 

The  AVF  concludes  that  the  testing  results  demonstrate  acceptable 
conformity  to  the  Ada  Standard. 

3.2  SUMMARY  OF  TEST  RESULTS  BY  CLASS 


RESULT 

A 

B 

TEST 

c 

CLASS 

D 

E 

L 

TOTAL 

Passed 

129 

1132 

1961 

17 

26 

46 

3311 

Inapplicable 

0 

6 

355 

0 

2 

0 

363 

Withdrawn 

1 

2 

34 

0 

6 

0 

43 

TOTAL 

130 

imo 

2350 

17 

34 

46 

3717 
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3.3  SUMMARY  OF  TEST  RESULTS  BY  CHAPTER 


RESULT  CHAPTER  TOTAL 


2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

Passed 

198 

577 

545 

245 

172 

99 

160 

333 

137 

36 

252 

260 

297 

3311 

Inappl 

14 

72 

135 

3 

0 

0 

6 

0 

0 

0 

0 

109 

24 

363 

Wdrn 

1 

1 

0 

0 

0 

0 

0 

1 

0 

0 

1 

35 

4 

43 

TOTAL 

213 

650 

680 

248 

172 

99 

166 

334 

137 

36 

253 

404 

325 

3717 

3.4  WITHDRAWN  TESTS 

The  following  U3  tests  were  withdrawn  from  ACVC  Version  1.10  at  the  time  of  this 
validation: 


E28005C 

A39005G 

B97102E 

BC3009B 

CD2A62D 

CD2A63A 

CD2A63B 

CD2A63C 

CD2A63D 

CD2A66A 

CD2A66B 

CD2A66C 

CD2A66D 

CD2A73A 

CD2A73B 

CD2A73C 

CD2A73D 

CD2A76A 

CD2A76B 

CD2A76C 

CD2A76D 

CD2A81G 

CD2A83G 

CD2A84M 

CD2A84N 

CD2B15C 

CD2D11B 

CD5007B 

CD50110 

ED7004B 

ED7005C 

ED7005D 

ED7006C 

ED7006D 

CD7105A 

CD7203B 

CD7204B 

CE3411B 

CD7205C 

CD7205D 

CE2107I 

CE3111C 

CE3301A 

See  Appendix  D  for  the  reason  that  each  of  these  tests  was  withdrawn. 


3.5  INAPPLICABLE  TESTS 

Scane  tests  do  not  apply  to  all  compilers  because  they  make  use  of  features  that 
a  compiler  is  not  required  by  the  Ada  Standard  to  support.  Others  may  depend  on 
the  result  of  another  test  that  is  either  inapplicable  or  withdrawn.  The 
applicability  of  a  test  to  an  implementation  is  considered  each  time  a 
validation  is  attempted.  A  test  that  is  inapplicable  for  one  validation  attempt 
is  not  necessarily  inapplicable  for  a  subsequent  attempt.  For  this  validation 
attempt,  363  tests  were  inapplicable  for  the  reasons  indicated: 


a.  The  following  201  tests  are  not  applicable  because  they  have 
floating-point  type  declarations  requiring  more  digits  than 
SYSTEM. MAX  DIGITS: 


C24113L..Y 
C35708L. .Y 
C45421L. .Y 
C45641L. .Y 


C35705L. .Y 
C35802L..Z 
C45521L. .Z 
C46012L..Z 


C35706L. .Y 
C45241L..Y 
C45524L. .Z 


C35707L. .Y 
C45321L. .Y 
C45621L. .Z 
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b.  C35702A  and  B86001T  are  not  applicable  because  this  rnplenentation 
supports  no  predefined  type  SHORT_FLOAT. 


c.  The  following  16  tests  are  not  applicable  because  this  implementation 
does  not  support  a  predefined  type  LONG_INTEGER : 


C45231C 

C45304C 

C45502C 

C45503C 

C45504C 

C45504F 

C45611C 

C45613C 

C45614C 

C45631C 

C45632C 

B52004D 

C55B07A 

B55B09C 

B86001W 

CD7101F 

d.  C45531M..P  (4 

tests)  and 

C45532M..P 

(4  tests) 

are  not  applicable 

because  the  value  of  SYSTEM. MAX_MANTISSA  is  less  than  47. 

e.  C86001F  is  not  applicable  because  this  implementation  does  not  support 
recompilation  of  package  SYSTQl. 

f.  B86001Y  is  not  applicable  because  this  implementation  supports  no 

predefined  fixed-point  type  other  than  DURATION. 

g.  B86001Z  is  not  applicable  because  this  implementation  supports  no 

predefined  floating-point  type  with  a  name  other  than  FLOAT, 

LONG_FLOAT,  or  SH6rT_FL0AT. 

h.  C87B62B  applies  the  attribute  'ST0RAGE_SI2E  to  an  access  type  for  Which 
no  STORAGE_SIZE  length  clause  is  given,  raising  STORAGE_ERROR.  The  AVO 
ruled  that”this  behavior  is  acceptable  and  the  test  is  not  applicable. 

i.  CD1009C,  CD2A41A..B  (2  tests),  CD2A41E,  CD2A42A..B  (2  tests), 

CD2A42E. .F  (2  tests),  and  CD2A42I..J  (2  teats)  are  not  applicable 

because  this  implementation  does  not  support  size  clauses  for  floating 
point  types . 

j .  The  following  28  tests  are  not  applicable  because  this  implementation 
does  not  support  size  clauses  for  derived  private  types; 


CD1C04A 

CD2A21C 

CD2A21D 

CD2A22C 

CD2A22D 

CD2A22G 

CD2A22H 

CD2A31C 

CD2A31D 

CD2A32C 

CD2A32D 

CD2A32G 

CD2A32H 

CD2A41C 

CD2A41D 

CD2A42C 

CD2A42D 

CD2A42G 

CD2A42H 

CD2A51C 

CD2A51D 

CD2A52C 

CD2A52D 

CD2A52G 

CD2A52H 

CD2A53D 

CD2A54D 

CD2A54H 

k.  CD1C04B,  CD1C04E,  and  CD4051A..D  (4  tests)  are  not  applicable  because 
this  implementation  does  not  support  representation  clauses  on  derived 
records  or  derived  tasks. 

l.  CD2A61A..D  (4  tests),  CD2A61F,  CD2A61H..L  (5  testa),  CD2A62A..C  (3 
tests),  CD2A71A..D  (4  tests),  CD2A72A..D  (4  tests),  CD2A74A..D  (4 
tests),  and  CD2A75A. .D  (4  tests)  are  not  applicable  because  of  the  way 
this  implementation  allocates  storage  space  for  one  component  of  an 
array  or  a  record.  The  size  specification  clause  for  an  array  type  or 
for  a  record  type  requires  compression  of  the  storage  space  needed  for 
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all  the  components,  without  gaps. 

m.  CD2A84B..I  (8  tests)  and  CD2A34K..L  (2  tests)  are  not  applicable 
because  this  implementation  does  not  support  size  clauses  for  access 
types . 

n.  CD4041A  is  not  applicable  because  this  implementation  does  not  support 
alignment  "at  mod  8". 

0.  CD5012J,  CD5013S,  and  CD5014S  are  not  applicable  because  this 

implementation  does  not  support  address  clauses  for  tasks . 

p.  The  following  21  tests  are  not  applicable  because  this  implementation 
does  not  support  an  address  clause  for  a  constant: 


CD5011B 

CD5011D 

CD5011F 

CD501 1H 

CD5011L 

CD5011N 

CD5011R 

CD5012C 

CD5012D 

CD5012G 

CD5012H 

CD5012L 

CD5013B 

CD5013D 

CD5013F 

CD5013H 

CD5013L 

CD5013N 

CD5013R 

CD5014O 

CD5014W 

q.  CE2102D  is  inapplicable  because  this  implementation  supports  CREATE 

with  IN_FILE  mode  for  SEQUENTIAL_IO. 

r.  CE2102E  is  inapplicable  because  this  implementation  supports  CREATE 

with  OUT_FILE  mode  for  SEQUENTIAL_IO. 

s.  CE2102F  is  inapplicable  because  this  implementation  supports  CREATE 

with  INOUT_FILE  mode  for  DIRECT_IO. 

t.  CS2102I  is  inapplicable  because  this  implementation  supports  CREATE 

with  IN_FILE  mode  for  DIRECT_IO. 

u.  CE2102J  is  inapplicable  because  this  implementation  supports  CREATE 

with  OUT_FILE  mode  for  DIRECT_IO. 

V.  CE2102N  is  inapplicable  because  this  implementation  supports  OPEN  with 
IN_FILE  mode  for  SEQUENT IAL_IO. 

w.  CE21020  is  inapplicable  because  this  implementation  supports  RESET  with 
IN_FILE  mode  for  SEQUENTIAL_IO. 

X.  CE2102P  is  inapplicable  because  this  implementation  supports  OPEN  with 
OUT_FILE  mode  for  SEQUENT IAL_IO. 

y.  CE2102Q  is  inapplicable  because  this  implementation  supports  RESET  with 
OUT_FILE  mode  for  SEQUENTIAL_IO . 

z.  CE2102R  is  inapplicable  because  this  implementation  supports  OPEN  with 
INOUT_FILE  mode  for  DIRECT_IO. 

aa.  CS2102S  is  inapplicable  because  this  implementation  supports  RESET  with 
INOUT  FILE  mode  for  DIRECT  10. 
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ab.  CE2102T  is  inapplicable  because  this  implementation  supports  OPEN  with 
IN_FILE  mode  for  DIRECT_IO. 

ac.  CE2102U  is  inapplicable  because  this  implementation  supports  RESET  with 
IN_FILE  mode  for  DIRECT_IO. 

ad.  CE2102V  is  inapplicable  because  this  implementation  supports  open  with 
0UT_FILE  mode  for  DIRECT_IO. 

ae.  CE2102W  is  inapplicable  because  this  implementation  supports  RESET  with 
OUT_FILE  mode  for  DIRECT_IO. 

af.  CE2401H  is  inapplicable  because  this  implementation  does  not  support 
CREATE  with  INOUT_FILE  mode  for  uncon? '.rained  records  with  default 
discriminants . 

ag.  CE3102E  is  inapplicable  because  this  implementation  supports  CREATE 
with  IN_FILE  mode  for  text  files. 

ah.  CE3102F  is  inapplicable  because  this  implementation  supports  RESET  for 
text  files. 

ai.  CE3102G  is  inapplicable  because  this  implementation  supports  deletion 
of  an  external  file  for  text  files. 

a j .  CE3102I  is  inapplicable  because  this  implementation  supports  CREATE 
with  OUT_FILE  mode  for  text  files. 

ak.  CE3102J  is  inapplicable  because  this  implementation  supports  OPEN  with 
IN_FILE  mode  for  text  files. 

al.  CE3102K  is  inapplicable  because  this  implementation  supports  OPEN  with 
OUT_FILE  mode  for  text  files. 

am.  EE2401D  and  EE2401G  are  not  applicable  because  USE_ERR0R  is  raised  when 
trying  to  create  a  file  with  unconstrained  array  types . 

3.6  TEST,  PROCESSING,  AND  EVALUATION  MODIFICATIONS 

It  is  expected  that  some  tests  will  require  modifications  of  code,  processing, 
or  evaluation  in  order  to  compensate  for  legitimate  implementation  behavior. 
Modifications  are  made  by  the  A'VF  in  cases  where  legitimate  implementation 
behavior  prevents  the  successful  completion  of  an  (otherwise)  applicable  test. 
Examples  of  such  modifications  include:  adding  a  length  clause  to  alter  the 
default  size  of  a  collection;  splitting  a  Class  3  test  into  subtests  so  that  all 
errors  are  detected;  and  confirming  that  messages  produced  by  an  executable  test 
demonstrate  conforming  behavior  that  wasn’t  anticipated  by  the  test  (such  as 
raising  one  exception  instead  of  another). 

Modifications  were  required  for  35  tests. 
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The  following  tests  were  split  because  syntax  errors  at  one  point  resulted  in 
the  compiler  not  detecting  other  errors  in  the  test: 


B23004A 

B24007A 

B24009A 

B25002A 

B26005A 

327005A 

B28003A 

B32202A 

B32202B 

B32202C 

B3300U 

B36307A 

B37004A 

B45102A 

B49003A 

B49005A 

B61012A 

B62001B 

B74304B 

B74401F 

B74401R 

B91004A 

B95004A 

B95032A 

B95069A 

BD5005B 

B95069B 

BA1101B 

BC2001D 

BC3009A 

BC3009C 

following 

modifications  were 

made  to 

compensate 

for  legitimate 

implementation  behavior: 

a.  At  the  recommendation  of  the  AVO,  the  expression  "2»»T 'MANTISSA  -  1"  on 
line  262  of  test  CC1223A  was  changed  to  "(2»»(T'MANTISSA-1 )-1  + 
2**( T 'MANTISSA-1 ) )"  since  the  previous  expression  causes  an  unexpected 
exception  to  be  raised. 

The  following  tests  were  graded  using  a  modified  evaluation  criteria: 


a.  BA2001E  expects  that  the  non-distinctness  of  names  of  subunits  with  a 

common  ancestor  be  detected  at  compile  time,  but  this  implementation 
detects  the  errors  at  link  time.  The  AVO  ruled  that  it  is  also 

acceptable  to  make  the  error  detection  at  link  time.  Thus,  this  test 

is  considered  to  be  passed  if  the  intended  errors  are  detected  at 
either  compile  or  link  time. 

b.  EA3004D  and  LA3004B  both  fail  to  detect  an  error  because  pragma  INLINE 

is  invoked  for  a  function  that  is  called  within  a  package 

specification.  By  re-ordering  the  files,  it  may  be  shown  that  INLINE 
indeed  has  no  effect.  The  AVO  has  ruled  that  both  are  to  be  run  as  is, 
noting  that  both  fail  to  detect  errors  where  INLINE  is  invoked  from 
within  a  package  specification.  The  compilation  files  are  then 
re-ordered.  For  EA3004D,  the  order  is  0,  1,  4,  5,  2,  3»  6;  and  for 
LA3004B,  the  order  is  0,  1,  5,  6,  2,  3>  4,  7.  The  tests  both  execute 
and  produce  the  expected  NOT_APPLICABLE  result,  as  though  INLINE  were 
not  supported  at  all.  Both  tests  are  graded  as  passed. 
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3.7  ADDITIONAL  TESTING  INFORMATION 


3.7.1  Prevail dat ion 

Prior  to  validation,  a  set  of  teat  results  for  ACVC  Version  1.10  produced  by  the 
HP  9000  Series  300  Ada  Compiler  was  submitted  to  the  AVF  by  the  applicant  for 
review.  Analysis  of  these  results  demonstrated  that  the  compiler  successfully 
passed  all  applicable  tests,  and  the  compiler  exhibited  the  expected  behavior  on 
all  inapplicable  tests. 


3.7.2  Test  Method 


Testing  of  the  HP  9000  Series  300  Ada  Compiler  using  ACVC  Version  1.10  was 
conducted  on-site  by  a  validation  team  from  the  AVF.  The  configuration  in  which 
the  testing  was  performed  is  described  by  the  following  designations  of  hardware 
and  software  components; 


Host  computer; 

Host  operating  system: 
Target  computer; 

Target  operating  system; 
Compiler: 


HP  9000  Series  300  Model  370 
HP-UX,  Version  6.5 
HP  9000  Series  300  Model  370 
HP-UX,  Version  6.5 

HP  9000  Series  300  Ada  Compiler,  Version  4.35 


A  magnetic  tape  containing  all  tests  except  for  withdrawn  tests  and  tests 
requiring  unsupported  floating-point  precisions  was  taken  on-site  by  the 
validation  team  for  processing.  Tests  that  make  use  of  implementation-specific 
values  were  customized  before  being  written  to  the  magnetic  tape.  Tests 
requiring  modifications  during  the  prevalidation  testing  were  included  in  their 
modified  form  on  the  magnetic  tape. 

The  contents  of  the  magnetic  tape  were  loaded  onto  a  file  server  which  was 
connected  to  the  host  computer  via  NFS. 

After  the  test  files  were  loaded  to  disk,  the  full  set  of  tests  was  compiled, 
linked,  and  all  executable  tests  were  run  on  the  HP  9000  Series  300  Model  370. 
Results  were  printed  from  the  from  the  host  computer. 

The  compiler  was  tested  using  command  scripts  provided  by  Hewlett  Packard  Co. 
and  reviewed  by  the  validation  team.  See  Appendix  E  for  a  complete  listing  of 
the  compiler  options  for  this  implementation.  The  compiler  was  tested  using  the 
following  option  settings; 


OPTION 


EFFECT 


■K3 

-L 

-c 


Suppresses  printing  names  of  consecutive 
sources  to  stdout. 

Produce  an  output  listing. 

Compile  and  bind  only.  The  link  phase  is 
run  separately  under  the  testing  automation, 
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using  only  the  default  options. 

-P  66  Set  the  out  page  length  to  66  lines. 

-W  c,  -SHOWsNONE  Suppresses  printing  of  headers  and  of  the 

summary  which  would  otherwise  appear  at  the 
end  of  the  compilation  listings. 

-e  999  Set  the  maximum  number  of  errors  to  999. 


Tests  were  compiled,  linked,  and  executed  (as  appropriate)  using  two  computers. 
Test  output,  compilation  listings,  and  job  logs  were  captured  on  magnetic  tape 
and  archived  at  the  AVF.  The  listings  examined  on-site  by  the  validation  team 
were  also  archived. 


3*7.3  Teat  Site 

Testing  was  conducted  at  Cupertino  CA  and  was  completed  on  4  May  1989. 
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DECLARATION  OF  CONFORMANCE 


Hewlett  Packard  Co.  has  submitted  the  following  Declaration 
of  Conformance  concerning  the  HP9000  Series  300  Ada 
Compiler . 
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DECLARATION  OF  CONFORMANCE 

Compiler  Implementor:  Hewlett  Packard  Company,  California  Language  Lab 
Ada  Validation  Facility:  ASD/SCEL,  Wright  Patterson  AFB,  OH  45433-6503 
Ada  Compiler  Validation  Capability  (ACVC)  Version:  1.10. 

Base  Configuration 

Base  Compiler  Name:  HP  9000  Series  300  Ada  Compiler,  Version  4.35. 

Host  Architecture  ISA;  HP  9000  Series  300  Model  370 

Host  OS  and  Version:  HP-UX,  Version  6.5 

Target  Architecture  ISA;  HP  9000  Series  300  Model  370 
Target  OS  and  Version;  HP-UX,  Version  6.5 

Derived  Compiler  Registration 

Derived  Compiler  Name;  HP  9000  Series  300  Ada  Compiler,  Version  4.35. 

Host  Architecture  ISA:  HP  9000  Series  300  Model  370 

Host  OS  and  Version:  HP-UX,  Version  7.0 

Target  Architecture  ISA;  HP  9000  Series  300  Model  370 
Target  OS  and  Version;  HP-UX,  Version  7.0 

Host  Architecture  ISA;  HP  9000  Series  300  Model  360 
Host  OS  and  Version;  HP-UX,  Version  7.0 
Target  Architecture  ISA;  HP  9000  Series  300  Model  360 
Target  OS  and  Version;  HP-UX,  Version  7.0 

Host  Architecture  ISA;  HP  9000  Series  300  Model  340 
Host  OS  and  Version;  HP-UX,  Version  7.0 
Target  Architecture  ISA;  HP  9000  Series  300  Model  340 
Target  OS  and  Version;  HP-UX,  Version  7.0 

Implementer’s  Declaration 

I,  the  undersigned,  representing  Hewlett  Packard  Company,  have  implemented  no 
deliberate  extentions  to  the  Ada  Language  Standard  ANSI/MIL-STD-1815A  in  the 
compilers  listed  in  this  declaration.  I  declare  that  Hewlett  Packard  Company  is 
owner  of  record  of  the  Ada  language  compilers  listed  above  and,  as  such,  is 
responsible  for  maintaining  said  compilers  in  conformance  to  ANSI/MIL-STD- 
1815A.  All  certificates  and^'registration  for  the  Ada  language  compiler  listed  in  this 
declaration  shall  be  made  only  in  the  owner’s  corporate  name. 


'  -  _  Date;. 

Hewlett  Packard  Company 

David  Graham 

Ada  R&D  Section  Manager 
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Owner’s  Declaration 


I,  the  undersigned,  representing  Hewlett  Packard  Company,  take  full  responsibility 
for  implementation  and  maintenance  of  the  Ada  compiler  listed  above,  and  agree  to 
the  public  disclosure  of  the  final  Validation  Summary  Report.  I  further  agree  to 
contmue  to  comply  with  the  Ada  trademark  policy,  as  defined  by  the  Ada  Joint 
Program  Office.  I  declare  that  all  of  the  Ada  lan^age  compilers  "listed,  and  their 
host /target  performance  are  in  compliance  with  the  Ada  Language  Standard 
ANSI/MI1^STD-1815A. 


_ _ _  Date:. 

Hewlett  Packard  Company 

David  Graham 

Ada  R&D  Section  Manager 
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APPENDIX  B 

APPENDIX  F  OF  THE  Ada  STANDARD 


The  only  allowed  implementation  dependencies  correspond  to 
implementation-dependent  pragmas,  to  certain  machine-dependent  conventions 
as  mentioned  in  chapter  13  of  the  Ada  Standard,  and  to  certain  allowed 
restrictions  on  representation  clauses.  The  implementation-dependent 
characteristics  of  the  HP  9000  Series  300  Ada  Compiler,  Version  4.35,  as 
described  in  this  Appendix,  are  provided  by  Hewlett  Packard  Co.  Unless 
specifically  noted  otherwise,  references  in  this  Appendix  are  to  compiler 
documentation  and  not  to  this  report.  Implementation-specific  portions  of 
the  package  STANDARD,  which  are  not  a  part  of  Appendix  F,  are: 


package  STANDARD  is 


type  INTEGER  is  range  -2147483648  ..  2147483647; 
type  SH0RT_INTEGER  is  range  -32768  ..  32767; 
type  SH0RT_SH0RT_INTEGER  is  range  -128  ..  127; 

type  FLOAT  is  digits  6  range  -2#1 . 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1#E+127 

. .  2#1 . 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1J  1 1 1J  1 1 1#E-t-127; 
type  L0NG_FL0AT  is  digits  15  range 

-2#1 . 1 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1J  1 1 1J  1 1 1J  1 1 1J  1 1 1J  1 1 1_1 1 1 1#E+1 023  . . 
2#1.1111_1111_1111_1111_1111_1111_1111_1111_1111_1111J111_1111_1111ffE+1023; 

type  DURATION  is  delta  2#0.000  000  000  000  01#  range  -86  400.0  ..  86  400.0; 


end  STANDARD; 
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F  1.  Implementation-Dependent  Pragmas 

This  section  describes  the  implementation -dependent  aspects  of  pragmas.  A  pragma  is  a  compiler 
directive  that  provides  a  way  to  control  the  behavior  of  one  or  more  components  of  the  Ada  compilation 
system. 

The  pragmas  listed  below  are  described  in  the  sections  which  follow; 

•  Pragmas  used  in  interfacing  with  subprograms  written  in  other  languages: 
p  ra  gma  I NTERF AC E 

pragma  INTERFACE_NAME 

•  Pragmas  used  to  support  text  processing  tools; 
pragma  INDENT 

•  Pragmas  that  affect  the  layout  of  array  and  record  types  in  memory: 
pragma  PACK 

pragma  IMPROVE 

•  Pragmas  that  are  not  implemented. 
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F  1.1  Interfacing  the  Ada  Language  with  Other  Languages 

Your  Ada  programs  can  call  subprograms  written  in  other  languages  when  you  use  the  predefined  pragmas 
INTERFACE  and  INTERFACE_NAME.  This  implementation  of  HP  .Ada  supports  subprograms  written  in 
HP  6  8K  Assembly  Language  HP  C,  HP  Pascal,  and  HP  FORTRAN  -T  for  HP  9000  Series  500  computers 
Note  that  compiler  products  from  vendors  other  than  HP  may  not  conform  to  the  parameter  passing 
conventions  given  below.  For  detailed  information,  instructions,  and  examples  for  interfacing  your  Ada 
programs  with  HP  b8K  .Assembly  Language,  HP  C,  HP  FORTRAN  7  7,  and  HP  Pascal,  see  Section  1  4 

The  pragma  INTERFACE  (LRM,  Section  1  3.9)  informs  the  compiler  that  a  non- Ada  external  subprogram 
will  be  supplied  when  the  Ada  program  is  linked.  ■  Pragma  INTERFACE  specifies  two  things:  the 
programming  language  used  in  the  external  subprogram  and  the  name  of  the  Ada  interfaced  subprogram. 
Implicit  in  the  language  specification  is  the  corresponding  parameter  calling  convention  to  be  used  in  the 
interface. 

The  implementation-defined  pragma  I NTERF ACE_NAME  associates  an  alternative  name  with  a  non-Ada 
external  subprogram  that  has  been  specified  to  the  Ada  program  by  the  pragma  INTERFACL 

The  two  pragmas  take  the  form: 

pragma  INTERFACE  (  Language _naine^  Ada_subprogram_name)\ 

pragma  INTERFACE_NAHE  (  Ada_subprogram_name ,  External jsubprogram_name)\ 

where: 


Language jiame  is  one  of  ASSEMBLER,  C,  FORTRAN,  or  PASCAL. 

Adajsubprogram_name  is  the  name  used  within  the  Ada  program  when  referring  to  the 

interfaced  external  subprogram. 

External  name  is  the  external  name  of  the  subprogram.  This  name  is  literal  and  case 
significant. 


Use  pragma  INTERFACE  NAME  whenever  the  interfaced  subprogram  name  contains  characters  not 
acceptable  within  Ada  names  or  when  the  interfaced  subprogram  name  must  contain  uppercase  letter(s). 
If  you  omit  pragma  INTERFACE_NAME,  the  name  used  is  the  name  of  the  subprogram  specified  in  pragma 
INTERFACE  with  all  alphabetic  characters  in  the  name  shifted  to  lower  case  and  then  truncated  to  255 
characters  if  necessary.  If  the  interfaced  subprogram  language  is  HP  C,  HP  Pascal  or  HP  FORTRAN  77, 
the  compiler  modifies  the  name  further  the  name  is  prefixed  with  one  underscore  character  (_)  and  then 
truncated  to  255  characters  if  necessary.  This  modification  conforms  to  the  naming  conventions  used  by 
the  HP  linker  (ld(l)  -  Link  Editor)  on  HP-UX  systems. 

Pragma  INTERFACE_NAME  is  allowed  at  the  same  places  in  an  Ada  program  as  pragma  INTERFACE  (  see 
LRM  Section  fJ.  9).  Pragma  INTERFACE_NAME  must  follow  the  declaration  of  the  corresponding 
pragma  INTERFACE  and  must  be  within  the  same  declarative  part,  though  it  need  not  immediately  follow 
that  declaration.  The  following  example  illustrates  the  use  of  these  pragmas. 
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EXAMPLE: 

package  SAMPLE_LIB  is 

function  SAMPLE_DEVICE  (X  :  INTEGER)  return  INTEGER; 
function  PROCESS_SAMPLE  (X  ;  INTEGER)  return  INTEGER; 

private 

pragma  INTERFACE  (ASSEMBLER,  SAMPLE_DEVICE  ); 
pragma  INTERFACE  (C,  PRCX:ESS_SAMPLE  ); 

pragma  INTERFACE  NAME  (SAMPLE_DEVICE,  "DevIO"  ); 
pragma  INTERFACE'nAME  (PR0CESS_SAMPLE,  "DoSample"  ); 

end  SAMPLE_LIB; 

In  this  example  we  have  defined  two  Ada  subprograms  that  are  known  in  Ada  code  as  SAMPLE_DEVICE 
and  PROCESS_SAMPLE.  When  a  call  to  SAMPLE  DEVICE  is  executed,  the  program  will  generate  a  call  to 
the  externally  supplied  assembly  function  Dev  10.  Likewise,  when  a  call  to  PRCX:;ESS_SAMPLE  is  executed,'*' 
the  program  will  generate  a  call  to  the  externally  supplied  C  function  DoSample. 

In  this  example  we  have  explictly  provided  the  names  for  the  external  subprograms  to  associate  with  the 
Ada  subprogram  by  using  Pragma  INTERFACE  NAME.  If  we  had  not  used  Pragma  INTERFACE_NAME 
then  the  two  external  names  referenced  would  be  sainple_device  and  process_^sample. 

It  is  important  to  note  an  object  file  or  an  object  library  that  defines  the  external  subprograms  must 
be  provided  as  a  command  line  parameter  to  the  Ada  binder.  If  you  fail  to  provide  an  object  file  that 
contains  the  definition  for  the  external  subprogram  the  Unix  linker  ld(  1 )  will  issue  an  error  message. 

To  avoid  conflicts  with  the  Ada  run-time  system,  the  names  of  interfaced  external  routines  should  not 
begin  with  the  letters  "RTS _ "  or  "ALSY"  in  any  combination  of  uppercase  and  lowercase. 

When  you  want  to  call  a  HP-UX  operating  system  library  subprogram  from  Ada  code,  you  should  use  a 
Pragma  INTERFACE  with  C  as  the  language  name.  You  should  use  Pragma  INTERFACE_NAME  and 
explictly  supply  the  external  name.  This  external  name  must  be  the  same  as  the  name  of  any  operating 
system  system  call  (see  Section  2  of  the  HP-UX  Reference)  or  the  name  of  any  HP-supplied  subprogram 
library  routine  (see  Section  3  of  the  HP-UX  Reference).  In  this  case  it  is  not  necessary  to  provide  the  C 
object  file  to  the  binder,  since  it  will  be  found  automatically  when  the  linker  searches  the  system  library. 

For  detailed  information  on  the  use  of  pragma  INTERFACE  and  pragma  INTERFACE_NAME,  see 
Section  F  1 4. 
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F  12  Pragma  INDENT 

Pragma  INDENT  is  ignored  by  the  compiler,  but  it  is  used  to  support  the  Ada  source  text  processing  tools 

The  pragmas  INDENT  (ON)  and  INDENT  (OFF)  affect  only  the  HP  supplied  reformatter  You  can  place 
these  pragmas  in  the  source  code  to  control  the  actions  of  the  reformatter.  Table  F-1  lists  the  use  of  each 
pragma. 


Table  F-1.  Pragma  Indent 


Pragma 

Description 

INDENT (OF^) 

The  reformatter  does  not  modify  the  source  lines  after  the  pragma. 

INDENT (ON) 

The  reformatter  resumes  its  action  after  the  pragma. 

F  13  Pragmas  Not  Implemented 

The  following  pragmas  are  not  implemented  and  will  issue  a  warning  at  compile  time: 


CONTROLLED 
MEMORY  SIZE 
OPTIMIZE 
SHARED 
STORAGE  UNIT 
SYSTEM  NAME 
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F  2.  Implementation-Dependent  Attributes 

In  addition  to  the  representation  attributes  discussed  in  the  LRM.  Sections  1  3.  7.  2  and  1  3.  7.  3,  there  are 
four  implementation-defined  attributes: 

'REC0RD_SI2E 
'VARIANT  INDEX 
'ARRAY  DESCRIPTOR 
'RECORD_DESCRIPTOR 

These  attributes  are  describe  in  section  4,  under  their  respective  types. 


F  2.1  Limitation  on  the  use  of  the  attribute  'ADDRESS 

The  attribute  'ADDRESS  is  implemented  for  all  prefixes  that  have  meaningful  addresses.  The  compiler 
will  issue  the  following  warning  message  when  the  prefix  for  the  attribute  'ADDRESS  does  not  denote  a 
object  that  has  a  meaningful  address. 

The  prefix  of  th«  'ADDRESS  attribute  denotes  a  program  unit  that 
has  no  meaningful  address:  the  result  of  such  an  evaluation  is 
SYSTEM. NULL  ADDRESS. 


The  following  entities  do  not  have  meaningful  addresses  and  will  cause  the  above  compilation  warning,  if 
used  as  a  prefix  to  '  ADDRESS: 

•  A  constant  that  is  implemented  as  an  immediate  value  (that  is,  the  constant  does  not  have  any  space 
allocated  for  it). 

•  A  package  identifier  that  is  not  a  library  unit  or  a  subunit 

•  A  function  that  renames  an  enumeration  literal. 


Additionally,  the  attribute  'ADDRESS  when  applied  to  a  subprogram  will  return  different  values, 
depending  upon  the  elaboration  time  of  the  subprogram.  In  particular  the  value  returned  by  the  attribute 
'ADDRESS  changes  after  elaboration  of  the  subprogram  body. 

This  can  be  a  problem  when  'ADDRESS  is  applied  to  a  subprogram  in  a  package  specification.  For  this 
reason  it  is  strongly  recommended  that  the  attribute  < au bp rog ram > 'ADDRESS  not  be  used  in  a  package 
specification  and  instead  be  used  only  in  the  package  body,  after  the  body  of  the  subprogram. 
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F  3.  The  SYSTEM  and  STANDARD  Packages 

This  section  contains  a  complete  listing  of  the  two  predefined  library  packages:  SYSTEM  and  STANDARD 
These  packages  both  contain  implementation-dependent  spe>.ifications. 

F  3.1  The  Package  SYSTEM 

The  specification  of  the  predefined  library  package  SYSTEM  follows; 

package  SYSTEM  is 

--  Standard  Ada  definitions 

type  NAME  is  (  HP9000  300  ); 

SYSTEM_NAME:  constant  NAME  :=  HP9000_300; 

STORAGE_UNIT:  constant  :=  8; 

MEMORY_SIZE:  constant  :*  (2«*31)-1; 

MIN_INT:  constant  ;=  -(2**31); 

MAX__INT:  constant  2»*31-1; 

MAX_DIGITS:  constant  :=  15; 

MAX_MANTISSA:  constant  :=  31; 

FINE_0ELTA:  constant  :=  2#1.0#e-31; 

TICK:  constant  :=  0.020;  --  20  milliseconds 

subtype  PRIORITY  is  INTEGER  range  1..127  ; 

type  ADDRESS  is  private; 

NULL_ADDRESS  :  constant  ADDRESS;  — set  to  NULL 
--  Address  arithmetic 

function  TO_INTEGER  (LEFT  :  ADDRESS)  return  INTEGER; 

function  TO_ADDRESS  (LEFT  :  INTEGER)  return  ADDRESS; 

Note  that  ADDRESS  +  ADDRESS  is  not  supported 
function  (LEFT  :  INTEGER;  RIGHT  :  ADDRESS)  return  ADDRESS; 

function  "+"  (LEFT  :  ADDRESS;  RIGHT  :  INTEGER)  return  ADDRESS; 

Note  that  INTEGER  -  ADDRESS  is  not  supported 
function  (LEFT  :  ADDRESS;  RIGHT  :  ADDRESS)  return  INTEGER; 

function  (LEFT  :  ADDRESS;  RIGHT  :  INTEGER)  return  ADDRESS; 
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function 

II  ^  II 

(LEFT  : 

address ; 

RIGHT  : 

ADDRESS) 

return 

BOOLEAN; 

f  unct ion 

(LEFT  ; 

ADDRESS; 

RIGHT  : 

ADDRESS) 

return 

BOOLEAN ; 

function 

(LEFT  ; 

ADDRESS; 

RIGHT  : 

ADDRESS) 

retu  rn 

BOOLEAN; 

f  unct ion 

(LEFT  : 

ADDRESS ; 

RIGHT  ; 

ADDRESS) 

return 

BOOLEAN; 

f  unct ion 

"mod" 

(LEFT  : 

ADDRESS; 

RIGHT  : 

POSITIVE) 

retu  rn 

NATURAL; 

function 

IS_NULL  (LEFT 

:  ADDRESS)  return  BOOLEAN; 

f  unct ion 

WORD_ 

ALIGNED 

(LEFT  :  ADDRESS) 

return  BOOLEAN; 

function 

ROUND 

(LEFT  : 

ADDRESS) 

return 

ADDRESS; 

--  return  the  given  address  rounded  to  the  next  lower  even  value 

procedure  COPY  (FROM  :  ADDRESS;  TO  :  ADDRESS;  SIZE  :  NATURAL); 

--  copy  SIZE  storage  units.  The  result  is  undefined  if 
--  the  two  storage  areas  overlap. 

--  functions  to  provide  some  READ/WRITE  operations  in  memory, 
generic 

type  ELEMENT_TYPE  is  private; 
function  FETCH  (FROM  :  ADDRESS)  return  ELEMENT_TYPE ; 

--  Return  the  bit  pattern  stored  at  address  FROM,  as  a  value  of 
--  specified  ELEMENT  TYPE.  This  function  is  NOT  implemented  for 
--  unconstrained  array  types. 

generic 

type  ELEMENT  TYPE  is  private; 
procedure  STORE'dNTO  :  ADDRESS;  OBJECT  :  ELEMENT__TYPE) ; 

--  Store  the  bit  pattern  representing  the  value  of  OBJECT, at 
--  address  INTO.  This  function  is  NOT  implemented  for 
--  unconstrained  array  types. 

private 

--  private  part  of  package  SYSTEM 


end  SYSTEM; 
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F  3.2  The  Package  STANDARD 

The  specification  of  the  predefined  library  package  STANDARD  follows; 


package  STANDARD  is 

--  The  operators  that  are  predefined  for  the  types  declared  in  this 
--  package  are  given  in  comments  since  they  are  implicitly  declared. 
--  Lower  case  is  used  for  pseudo-names  of  anonymous  types  (such  as 
--  universal  real,  universal  integer,  and  universal_f ixed)  and  for 
--  undefined  information  (such  as  any  fixed  point  type). 


--  Predefined  type  BOOLEAN 

--  Naming:  internal  representation  of  BOOLEAN  is  MOT  simply  0,1 
type  BOOLEAN  is  (FALSE,  TRUE); 


--  The  predefined  relation  operators  for 
--  (these  are  implicitly  declared): 

--  function  "="  (LEFT,  RIGHT  :  BOOLEAN) 
--  function  “ /='  (LEFT,  RIGHT  :  BOOLEAN) 
--  function  "<"  (LEFT,  RIGHT  :  BOOLEAN) 
--  function  "<="  (LEFT,  RIGHT  :  BOOLEAN) 
--  function  ">"  (LEFT,  RIGHT  :  BOOLEAN) 
--  function  ">="  (LEFT,  RIGHT  :  BOOLEAN) 


this  type  are  as  follows 

return  BOOLEAN; 
return  BOOLEAN; 
return  BOOLEAN; 
return  BOOLEAN; 
return  BOOLEAN; 
return  BOOLEAN; 


--  The  predefined  logical  operands  and  the  predefined  logical 
--  negation  operator  are  as  follows  (these  are  implicitly 
--  declared): 


--  function  "and"  (LEFT,  RIGHT  :  BOOLEAN) 

--  function  "or"  UEH",  RIGHT  :  BOOLEAN) 

--  function  "xor"  (LEFT,  RIGHT  :  BOOLEAN) 


return  BOOLEAN; 
return  BOOLEAN; 
return  BOOLEAN; 


function  "not"  (RIGHT  :  BOOLEAN)  return  BOOLEAN; 


--  Predefined  universal  types 


--  type  universal  integer  is  predefined; 

--  The  predefined  operators  for  the  type  universal_integer  are  as  follows 
--  (these  are  implicitly  declared): 

--  function  "="  (LEFT,  RIGHT  :  universal_integer)  return  BOOLEAN; 

--  function  "/="  (LEFT,  RIGHT  :  universai_integer)  return  BOOLEAN; 

--  function  ”<”  (LEFT,  RIGHT  :  universa l_integer)  return  BOOLEAN; 

--  function  "<="  (LEFT,  RIGHT  :  universal_integer )  ret'irn  BOOLEAN; 

--  function  ">"  (LEFT,  RIGHT  :  universal_integer)  return  BOOLEAN; 

--  function  ">="  (LEFT,  RIGHT  :  universai_integer)  return  BOOLEAN; 
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--  function  "+"  (RIGHT  :  un iversal_integer)  return  universal_integer ; 

--  function  (RIGHT  :  un iversal_integer )  return  universal_integer; 

--  function  "abs"  (RIGHT  ;  un iversal_integer )  return  un iversa l_integer ; 

--  function  (LEFT,  RIGHT  ;  universal_integer )  return  universal  integer; 

--  function  (LEFT,  RIGHT  :  universal_integer)  return  universal  integer; 

--  function  (LEFT,  RIGHT  :  universe l_integer)  return  universal_integer; 

--  function  "/"  (LEFT,  RIGHT  ;  universe l_integer)  return  universal  integer; 

--  function  "rem"  (LEFT,  RIGHT  :  universal_integer)  return  universal  integer; 

--  function  "mod"  (LEFT,  RIGHT  :  universal_integer)  return  universal  integer; 

--  function  "**"  (LEFT  :  un iversal_integer; 

RIGHT  :  INTEGER)  return  un iversal_integer; 


--  type  univer8al_real  is  predefined; 

--  The  predefined  operators  for  the  type  universal_real  are  as  follows 
--  (these  are  implicitly  declared): 

—  function  (LEFT,  RIGHT  :  universal_real)  return  BOOLEAN; 

--  function  "/="  (LEFT,  RIGHT  :  universai_real)  return  BOOLEAN; 

--  function  "<"  (LEFT,  RIGHT  :  univer8al_real)  return  BOOLEAN; 

--  function  "<="  (LEFT,  RIGHT  :  univer8al_real)  return  BOOLEAN; 

—  function  ">"  (LEFT,  RIGHT  :  universal_real)  return  BOOLEAN; 

—  function  ">="  (LEFT,  RIGHT  :  universal_real )  return  BOOLEAN; 

--  function  (RIGHT  :  universai_^real)  return  universal_real ; 

--  function  (RIGHT  ;  un  iversa l__real)  return  univer8al_real; 

--  function  "aba"  (RIGHT  :  .universal_^real)  return  universal_real; 

--  function  "+"  (LEFT,  RIGHT  :  univer8al_real)  return  universal_real ; 

--  function  (LEFT,  RIGHT  ;  un i versa l__real)  return  universal_real ; 

--  function  (LEFT,  RIGHT  :  universal_real )  return  universal  real; 

--  function  "/"  (LEFT,  RIGHT  :  universal_real)  return  universal_real ; 

—  function  "•*"  (LEFT  :  universal_real; 

RIGHT  :  INTEGER)  return  universal  real; 

--  In  addition,  the  following  operators  are  predefined  for  universal  types: 

--  function  (LEFT  :  un iversal_^integer; 

RIGHT  :  universal__real)  return  universal_real ; 

--  function  (LEFT  :  un iversal^real ; 

RIGHT  :  un iversal^integer)  return  universal_real; 

--  function  "/"  (LEFT  :  un iversal_real; 

RIGHT  :  universal  integer)  return  universal_real ; 


--  type  un iversa l_fixed  is  predefined; 

--  The  only  operators  declared  for  this  type  are: 

--  function  (LEFT  :  any_f ixed__point_type; 

RIGHT  :  any_fixed  point  type)  return  universal  fixed; 
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--  function  "/"  (LEFT  :  any_f ixed_point_typ« ; 

RIGHT  :  any  f ixed_point_typ«)  return  un iversa l_f ixed ; 


--  Predefined  and  additional  integer  types 

type  SHORT_SHORT_INTEGER  is  range  -128  ..  127;  --  8  bits  long 
--  this  is  equivalent  to  -(2**7)  ..  (2<**7  -1) 

--  The  predefined  operators  for  this  type  are  as  follows 
--  (these  are  implicitly  declared): 

--  function  "  =  "  (LEFT,  RIGHT  :  SHORT_SHORT_INTEGER)  return  BCXDLEAN ; 

--  function  *7="  (LEFT,  RIGHT  :  SHORT  SHORT_INTEGER )  return  800LEAN ; 

--  function  "<"  (LEFT,  RIGHT  :  SHORT'shORT  INTEGER)  return  BOOLEAN; 

--  function  "<="  (LEFT,  RIGHT  :  SHORT  SHORT~INTEGER)  return  BOOLEAN; 

--  function  UEFT,  RIGHT  :  SH0RT“SH0RT~INTEGER )  return  BOOLEAN; 

--  function  ">="  UEfT,  RIGHT  ;  SHORT~SHORT_INTEGER)  return  BOOLEAN; 

--  function  (RIGHT  :  SHORT  SHORT  INTEGER)  return  SHORT  SHORT_INTEGER 

--  function  (RIGHT  :  SHORT“shORT“inTEGER)  return  SHORT~SHORT_INTEGER 

--  function  "abs"  (RIGHT  ;  SHORT“sHORT~INTEGER)  return  SHORT~SHORT  INTEGER 


function 


--  function 


--  function 


--  function 


--  function 


--  function 


(LEFT 
retu 
(LEFT 
retu 
(LEFT 
retu 
’7"  (LEFT 
retu 
"rem"  (LEFT 
retu 
"mod"  (LEFT 


,  RIGHT 
m  SHORT 
,  RIGHT 
rn  SHORT 
,  RIGHT 
rn  SHORT 
,  RIGHT 
rn  SHORT 
,  RIGHT 
m  SHORT 
,  RIGHT 
rn  SHORT 


SHORT 

SHORT_ 

■  SHORT 
SHORT_ 

■  SHORT 
SHORT  ' 

■  SHORT 
SHORT 

■  SHORT 
SHORT_ 

■  SHORT 
SHORT 


SHORT_ 

INTEGER 

SHORT 

INTEGER 

SHORT 

INTEGER 

SHORT 

INTEGER 

SHORT 

INTEGER 

SHORT 

INTEGER 


INTEGER) 

INTEGER) 

INTEGER) 

INTEGER) 

INTEGER) 

INTEGER) 


--  function  "*♦"  (LEFT  :  SHORT_SHORT  INTEGER; 

RIGHT  :  INTEGER)  return  SHORT  SHORT  INTEGER; 


type  SHORT_INTEGER  is  range-32_768  ..  32_767;  --16  bits  long 

--  this  is  equivalent  to  -(2**15)  ..  (2**15  -1) 

--  The  predefined  operators  for  this  type  are  as  follows 
--  (these  are  implicitly  declared): 

--  function  "»**  (LEFT,  RIGHT  :  SHORT_INTEGER )  return  BOOLEAN; 

--  function  "/«"  (LEFT,  RIGHT  :  SHORT  INTEGER)  return  BOOLEAN; 

--  function  "<"  (LEFT,  RIGHT  ;  SHORT“inTEGER)  return  BOOLEAN; 

--  function  "<="  (LEFT,  RIGHT  ;  SHORT'INTEGER)  return  BOOLEAN; 

--  function  ">"  (LEFT,  RIGHT  :  SHORT_INTEGER)  return  BOOLEAN; 

--  function  ">="  (LEFT,  RIGHT  :  SHORT_INTEGER)  return  BOOLEAN; 

--  function  "■*•"  (RIGHT  :  SHORT  INTEGER)  return  SHORT  INTEGER; 

--  function  "-"  (RIGHT  :  SHORT~INTEGER)  return  SHORT“inTEGER; 

--  function  "abs"  (RIGHT  :  SHORT  INTEGER)  return  SHORT'inTECER; 


B-11 


Implementation  -Dependent  Characteristics 


--  function 

(LEFT,  RIGHT  : 

SHORT 

INTEGER) 

return 

SHORT 

INTEGER 

--  function 

(LEFT,  RIGHT  : 

short" 

’integer) 

return 

short" 

INTEGER 

--  function 

• 

(LEFT,  RIGHT  : 

SHORT 

INTEGER) 

return 

short" 

INTEGER 

--  function 

7"  ^ 

(LEFT,  RIGHT  : 

short" 

INTEGER) 

return 

short" 

INTEGER 

--  function 

"  rem" 

(LEFT,  RIGHT  : 

short_ 

INTEGER) 

return 

short" 

INTEGER 

--  function 

“mod" 

(LEFT,  RIGHT  : 

Short" 

INTEGER) 

return 

short" 

INTEGER 

--  function 

(LEFT  :  SHORT 

INTEGER; 

RIGHT  :  INTEGER)  return  SHORT  INTEGER; 


type  INTEGER 


is  range  -2_1 47_4a3_648 


2_147_4e3_647;  --32  bits  long 


this  is  equival 
The  predefined 
(these  are  impl 

( 


-- 

function 

II  _ii 

-- 

function 

— 

f  unction 

-- 

function 

— 

function 

-- 

function 

-- 

function 

-- 

function 

II  14 

-- 

function 

"abs 

.  - 

function 

-- 

function 

««  «« 

-- 

function 

-- 

function 

II  y  II 

-- 

function 

M 

rem 

-- 

fu'^iction 

"mod 

-  - 

function 

ent  to  -(2**31)  ..  (2**31  - 
operators  for  this  type  are 
icitly  declared) : 

LEFT,  RIGHT  ;  INTEGER)  retu 


LEFT,  RIGHT 
LEFT,  RIGHT 
LEFT,  RIGHT 
LEFT,  RIGHT 
LEFT,  RIGHT 


INTEGER)  retu 
INTEGER)  retu 
INTEGER)  retu 
INTEGER)  retu 
INTEGER)  retu 


1) 

as  follows 


rn  BOOLEAN 
rn  BOOLEAN 
rn  BOOLEAN 
rn  BOOLEAN 
rn  BOOLEAN 
rn  BOOLEAN 


(RIGHT  :  INTEGER)  return  INTEGER 
(RIGHT  :  INTEGER)  return  INTEGER 
(RIGHT  ;  INTEGER)  return  INTEGER 


(LEFT,  RIGHT 
(LEFT,  RIGHT 
(LEFT,  RIGHT 
(LEFT,  RIGHT 
(LEFT,  RIGHT 


INTEGER) 

INTEGER) 

INTEGER) 

INTEGER) 

INTEGER) 

INTEGER) 


return  INTEGER 
return  INTEGER 
return  INTEGER 
return  INTEGER 
return  INTEGER 
return  INTEGER 


(LEFT  :  INTEGER;  RIGHT  :  INTEGER)  return  INTEGER; 


--  Predefined  INTEGER  subtypes 

subtype  NATURAL  is  INTEGER  range  0  ..  INTEGER ' LAST; 
subtype  POSITIVE  is  INTEGER  range  1  ..  INTEGER' LAST; 


--  Predefined  and  additional  floating  point  types 

type  FLOAT  is  digits  6  range  --  32  bits  long 
-2#1.111  1111  1111  1111  1111  1111#E+127  .. 

2#1  .111J111  J11l“l111  J111J111#E+127; 

--  This  is  equivalent  to  -(2.0  -  2.0**(-23))  *  2.0**127  .. 
+(2.0  -  2.0**(-23))  •  2.0**127  ,. 

This  is  approximately  equal  to  the  decimal  range: 

--  -3.402823E+38  ..  +3 . 402823E+38 


B-12 


Implementation -Dependent  Characteristics 


--  The  predefined  operators  for  this  type  are  as  follows 
--  (these  are  implicitly  declared): 

--  function  "=”  (LEFT,  RIGHT  :  FLOAT)  return  BOOLEAN; 

--  function  "/="  (LEFT,  RIGHT  :  FLOAT)  return  BOOLEAN; 

--  function  "<"  (LEFT,  RIGHT  :  FLOAT)  return  BOOLEAN; 

--  function  "<="  (LEFT,  RIGHT  :  FLOAT)  return  BOOLEAN; 

--  function  '■>"  (LEFT,  RIGHT  :  FLOAT)  return  BOOLEAN; 

--  function  ">="  (LEFT,  RIGHT  :  FLOAT)  return  BOOLEAN; 

--  function  •'  +  "  (RIGHT  :  FLOAT)  return  FLOAT; 

--  function  (RIGHT  :  FLOAT)  return  FLOAT; 

--  function  "abs"  (RIGHT  :  FLOAT)  return  FLOAT; 

--  function  (LEFT,  RIGHT  :  FLOAT)  return  FLOAT; 

--  function  (LEFT,  RIGHT  :  FLOAT)  return  FLOAT; 

--  function  (LEFT,  RIGHT  :  FLOAT)  teturn  FLOAT; 

--  function  " /"  (LEFT,  RIGHT  :  FLOAT)  return  FLOAT; 

--  function  "**"  (LEFT  :  FLOAT;  RIGHT  :  INTEGER)  return  FLOAT; 


type  LONG_FLOAT  is  digits  15  range  —  64  bits  long 

-2#1 , 11 1 1_11 11_1 1 1 1_11 11_1 11 1_1 1 1 1_1 1 11_1 1 11_1 1 1 1_1 111_1 11 1_11 11_111 1#E+1 023 

2#1  . 1 1 1 1_1 1 1 1__1 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1_1 1 1  1_1 1 1 1_1 1 1 1_1 1 1 1_1 1 1 1_1 1  1 1#E+1023; 

--  This  is  equivalent  to  -(2.0  -  2.0»*(-52))  *  2.0**1023  .. 

+(2.0  -  2.0**(-52))  •  2.0**1023  .. 

—  This  is  approximately  equal  to  the  decimal  range: 

- 1 .797693 1348623 15£+30a  ..  +1 . 797693 1348623 15E+308 

--  The  predefined  operators  for  this  type  are  as  follows 
--  (these  are  implicitly  declared): 

--  function  (LEFT,  RIGHT  :  LONG_FLOAT)  return  BOOLEAN; 

--  function  "/="  (LEFT,  RIGHT  :  LONG_FLOAT)  return  BOOLEAN; 

--  function  "<"  (LEFT,  RIGHT  :  LONG_FLOAT)  return  BOOLEAN; 

--  function  "<="  (LEFT,  RIGHT  :  LONG  FLOAT)  return  BOOLEAN; 

--  function  ">"  (LEFT,  RIGHT  :  LONG'flOAT)  return  BOOLEAN; 

--  function  ")="  ^EFT,  RIGHT  ;  LONG'FLOAT)  return  BOOLEAN; 

--  function  "+"  (RIGHT  :  LONG  FLOAT)  return  LONG  FLOAT; 

--  function  (RIGHT  :  L0NG“FL0AT)  return  L0NG“fL0AT; 

--  function  "aba"  (RIGHT  :  LONG>LOAT)  return  L0NG“fL0AT; 

--  function  (LEFT,  RIGHT  ;  LONG  FLOAT)  return  LONG  FLOAT; 

--  function  "-"  (LEFT,  RIGHT  :  LONC'flOAT)  return  L0NC~FL0AT; 

--  function  "*"  (LEFT,  RIGHT  :  LONG"FLOAT)  return  LONG'fLOAT; 

--  function  "/"  UEFT,  RIGHT  :  L0NG_FL0AT)  return  L0NG“fL0AT; 

--  function  "**"  (LEFT  :  LONG  FLOAT;  RIGHT  :  INTEGER)  return  LONG_FLOAT; 


--This  implementation  does  not  provide  any  other  floating  point  types 
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--  Predefined  type  DURATION 

type  DURATION  is  delta  2#0 . 000_000_000_000_01 #  range  -86_400.0  ..  86  400.0; 

--  DURATION 'SMALL  derived  from  this  delta  is  2.0**(-14)  ,  which  is  the 
--  maximum  precision  that  an  object  of  type  DURATION  can  have  and  still 
--  be  representable  in  this  implementation.  This  has  an  approximate 
--  decimal  equivalent  of  0.000061  (61  microseconds). 

--  The  predefined  operators  for  the  type  DURATION  are  the  same  as  for  any 
--  fixed  point  type. 

--  This  implementation  provides  many  anonymous  predefined  fixed  point 
--  types.  They  consist  of  all  types  whose  "small"  value  is 
--  any  power  of  2.0  between  2.0  (-31)  and  2.0  •*  (31), 

--  and  whose  mantissa  can  be  expressed  using  31  or  less  binary  digits. 

--  The  following  lists  characters  for  the  standard  ASCII  character  set. 

--  Character  literals  corresponding  to  control  characters  are  not 
--  identifiers;  they  are  indicated  in  lower  case  in  this  section. 


--  Predefined 

type 

CHARACTER 

type  CHARACTER  is 

(  nul. 

aoh , 

stx. 

etx , 

eot,  enq. 

ack. 

bel. 

bs. 

ht. 

if. 

vt. 

ff,  cr. 

so. 

ai. 

die, 

del , 

dc2. 

dc3. 

dc4,  nak. 

syn. 

etb. 

can, 

en. 

sub. 

esc. 

fs,  gs. 

rs. 

us , 

/  0 

% 

'  f ' 

% 

0  *%  0 

'#', 

'%', 

'fc'. 

0  0  0 

t 

0  0  0  0 

0  0 

•  \ 

'O', 

'1', 

'2', 

'3', 

'4',  'S', 

'6', 

'7', 

'8', 

'9', 

'  .  ' 

•  » 

t  % 

0^0  0^0 

'A', 

'B', 

'C', 

'D',  'E', 

'F', 

'G', 

'H', 

'I', 

'J', 

'K', 

'L',  'M'. 

'N', 

'O', 

'P', 

'Q', 

'R', 

'S', 

'T',  'U', 

'V', 

'W', 

'X', 

'Y', 

'Z', 

0  0^  0 

♦ 

0  0 

0  0 

% 

'a' , 

'b'. 

0  0 
c  , 

0^0  0  0 
d  ,  e  , 

'f'. 

0  0 
g  > 

'h'. 

'  i' , 

'  J ' , 

'k'. 

1  ,  m  , 

'n'. 

0  0 
o  , 

0  0 

P  , 

0  0 
q  , 

0  0 
f  , 

'a' , 

't',  'u'. 

0  0 

V  , 

'w' , 

0  0 

X  , 

0  0 
y  , 

'z'. 

'1',  ')', 

0  am  0 

* 

DEL); 

--The  predefined  operators  for  the  type  CHARACTER  are  the  same  as 
--for  any  enumeration  type. 


--  Predefined  type  STRING  (RM  3.6.3) 

type  STRING  is  array  (POSITIVE  range  <>)  of  CHARACTER; 

--  The  predefined  operators  for  this  type  are  as  follows: 
--  function  (LEFT,  RIGHT  :  STRING)  return  BOOLEAN; 

--  function  " (LEFT,  RIGHT  :  STRING)  return  BOOLEAN; 

--  function  (LEFT,  RIGHT  :  STRING)  return  BOOLEAN; 

--  function  "<="  (LEFT,  RIGHT  :  STRING)  return  BOOLEAN; 
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--  function  ">“  (LEFT,  RIGHT  :  STRING)  return  BOOLEAN; 

--  function  ">  =  '*  (LEFT,  RIGHT  :  STRING)  return  BOOLEAN; 

--  Predefined  catenation  operators 

--  function  "i"  (LEFT  ;  STRING;  RIGHT  :  STRING)  return  STRING; 

--  function  "i"  (LEFT  :  CHARACTER;  RIGHT  ;  STRING)  return  STRING; 

--  function  (LEFT  :  STRING;  RIGHT  :  CHARACTER)  return  STRING; 

--  function  "i"  (LEFT  :  CHARACTER;  RIGHT  ;  CHARACTER)  return  STRING; 


--  Predefined  exceptions 
CONSTRAlNT_ERROR  :  exception; 

NUMERIC_ERROR  :  exception; 

PROGRAM_ERROR  :  exception; 

STORAGE_ERROR  :  exception; 

TASKING  ERROR  :  exception; 


--  Predefined  package  ASCII 
package  ASCII  is 


--  Control  characters 

NUL 

constant 

CHARACTER 

;  s 

nul ; 

SOH 

constant 

CHARACTER 

1  = 

soh ; 

STX 

constant 

CHARACTER 

1  s 

stx ; 

ETX 

constant 

CHARACTER 

;  = 

etx ; 

EOT 

constant 

CHARACTER 

:  ® 

eot ; 

ENQ 

constant 

CHARACTER 

:  • 

enq; 

ACK 

constant 

CHARACTER 

*  s 

ack; 

BEL 

constant 

CHARACTER 

t  ^ 

bel ; 

BS 

constant 

CHARACTER 

:  s 

bs; 

HT 

constant 

CHARACTER 

:  = 

ht; 

LF 

constant 

CHARACTER 

:  = 

If; 

VT 

constant 

CHARACTER 

:  = 

vt; 

FF 

constant 

CHARACTER 

:  = 

ff; 

CR 

constant 

CHARACTER 

:  = 

cr; 

SO 

constant 

CHARACTER 

:  = 

so; 

SI 

constant 

CHARACTER 

;  = 

si; 

DLE 

constant 

CHARACTER 

;  = 

die; 

DC1 

constant 

CHARACTER 

;  = 

dc1 ; 

DC2 

constant 

CHARACTER 

:  = 

dc2; 

DC3 

constant 

CHARACTER 

;  = 

dc3; 

DC4 

constant 

CHARACTER 

:  = 

dc4; 

NAK 

constant 

CHARACTER 

:  s 

nak ; 

SYN 

constant 

CHARACTER 

;  = 

syn; 

ETB 

constant 

CHARACTER 

;  = 

etb; 

CAN 

constant 

CHARACTER 

*  m 

can; 

EM 

constant 

CHARACTER 

1  s 

em; 

SUB 

constant 

CHARACTER 

1  * 

sub; 

ESC 

constant 

CHARACTER 

:  = 

esc; 

FS 

constant 

CHARACTER 

;  s 

fa; 

GS 

constant 

CHARACTER 

;  s 

ga; 

RS 

constant 

CHARACTER 

:  = 

ra; 
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US  :  constant  CHARACTER  :=  us; 
DEL  :  constant  CHARACTER  del; 


other  characters 


EXCLAM 

constant 

CHARACTER 

= ' ! ' 

QUOTATION 

constant 

CHARACTER 

^  /  II  / 

SHARP 

constant 

character 

=  '#' 

DOLLAR 

constant 

character 

PERCENT 

constant 

CHARACTER 

AMPERSAND 

constant 

CHARACTER 

COLON 

constant 

CHARACTER 

S  • 

SEMICOLON 

constant 

CHARACTER 

^  y 

QUERY 

constant 

CHARACTER 

-'7' 

AT  SIGN 

constant 

CHARACTER 

L  BRACKET 

constant 

CHARACTER 

BACK  SLASH 

constant 

CHARACTER 

R  BRACKET 

constant 

CHARACTER 

CIRCUMFLEX 

constant 

CHARACTER 

— .  ^  A  ' 

UNDERLINE 

constant 

CHARACTER 

^  ^  # 

GRAVE 

constant 

CHARACTER 

L  BRACE 

constant 

CHARACTER 

BAR 

constant 

CHARACTER 

R  BRACE 

constant 

CHARACTER 

TILDE 

constant 

CHARACTER 

--  Lower  case  letters 


LC  A  :  constant  CHARACTER 

=  'a' 

LC“B  :  constant  CHARACTER 

=  'b' 

LC”C  :  constant  CHARACTER 

=  'c' 

LC"0  :  constant  CHARACTER 

«  'd' 

LC”E  ;  constant  CHARACTER 

_  ^  A 

*  e 

LC“F  :  constant  CHARACTER 

LC  G  :  constant  CHARACTER 

=  '9' 

LC”h  :  constant  CHARACTER 

*  'h' 

LC”l  :  constant  CHARACTER 

_  e  •  ^ 

*  1 

LC”j  :  constant  CHARACTER 

-  J 

LC“k  :  constant  CHARACTER 

=  'k' 

LC“l  :  constant  CHARACTER 

*  '1' 

LC_M  :  constant  CHARACTER 

=  'm ' 

LC”n  :  constant  CHARACTER 

=  n 

LC“0  ;  constant  CHARACTER 

r  f 

-  0 

LC_P  ;  constant  CHARACTER 

_  ^  9 

*  P 

LC”q  :  constant  CHARACTER 

9  9 

~  q 

LC“r  :  constant  CHARACTER 

=  'r' 

LC_S  :  constant  CHARACTER 

»  's' 

LC  T  :  constant  CHARACTER 

«  't' 

LC  U  :  constant  CHARACTER 

_  99 

a  U 

LC”V  ;  constant  CHARACTER 

a  'v' 

LC_W  :  constant  CHARACTER 

a  w 

LC“X  :  constant  CHARACTER 

a  'x' 

LC“y  :  constant  CHARACTER 

=  'y' 

LC“Z  :  constant  CHARACTER 

=  'z' 

end  ASCII; 
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--Certain  aspects  of  the  predefined  entities  cannot  be  completely 
--described  in  the  language  itself.  For  example,  a’ enough  the 
--enumeration  type  BOOLEAN  can  be  written  showing  the  two 
--enumeration  literals  FALSE  and  TRUE,  the  short-ci rcuit  control 
--forms  cannot  be  expressed  in  the  language. 

end  STANDARD; 
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F  4.  Type  Representation  Clauses 

The  aim  of  this  action  is  to  explain  how  data  objects  are  represented  and  allocated  by  the  HP  Ada 
compiler  for  the  HP  9000  Senes  300  Computer  System  and  how  it  is  possible  to  control  this  using 
representation  clauses. 

The  representation  of  a  data  object  is  closely  connected  with  its  type.  For  this  reason  this  section 
addresses  successively  the  representation  of  enumeration,  integer,  floating  point,  fixed  point,  access,  task, 
array  and  record  types.  For  each  class  of  type  the  representation  of  the  corresponding  data  object  is 
described. 

Except  in  the  case  of  array  and  record  types,  the  description  for  each  class  of  type  is  independent  of  the 
others.  Since  array  and  record  types  are  composite  types,  it  is  necessary  to  understand  first  the 
representation  of  it’s  components. 

Ada  provides  several  methods  to  control  the  layout  and  size  of  data  objects.  The  five  methods  that  are 
available  for  users  of  HP  Ada  for  the  HP  9000  Series  300  Computer  System  are: 


•"a  pragma  PACK,  when  the  type  is  an  array  type 
•"a  pragma  IMPROVE,  when  the  type  is  a  record  type 

•"an  enumeration  representation  clause,  when  the  type  is  an  enumeration  type, 
•"a  record  representation  clause,  when  the  type  is  a  record  type 
•"a  size  specification  clause,  for  any  type 


F  4.1  Enumeration  Types 


Internal  codes  of  enumeration  literals 

When  no  enumeration  representation  clause  applies  to  an  enumeration  type,  the  internal  code  associated 
with  an  enumeration  literal  is  the  position  number  of  the  enumeration  literal.  Thus,  for  an  enumeration 
type  with  n  elements,  the  internal  codes  are  the  integers  0,  1,  2, ..  ,  n-1. 

An  enumeration  representation  clause  can  be  provided  to  specify  the  value  of  each  internal  code  as 
describe  in  RM  13.3.  The  values  used  to  specify  the  internal  codes  must  be  in  the  range  -(2**31)  to 
(2**31)-1. 

The  predefined  BOOLEAN  type  is  internally  represented  as  an  8  bit  enumeration  type  that  uses 

2#0000 _ 0000#  and  2#1 1 1 1 _ 1 1 1 1#  as  the  internal  codes  for  FALSE  and  TRUE  respectively.  If  a  size 

specification  clause  is  applied  to  a  derived  boolean  type  then  the  internal  code  for  TRUE  has  all  the  bits 
turned  on  and  the  representation  of  FALSE  has  all  the  bits  turned  off.  These  value  are  defaults  only, 
they  can  be  changed  by  using  an  enumeration  representation  clause  on  the  derived  boolean  type. 

The  following  example  illustrates  the  use  of  an  enumeration  representation  clause. 
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EXAMPLE; 


type  COLOR  is  (RED,  ORANGE,  YELLOW,  GREEN,  AQUA,  BLUE,  VIOLET); 


for  COLOR  use 

(RED  => 
ORANGE  => 
YELLOW  => 
GREEN  => 
AQUA  => 
BLUE  => 
VIOLET  => 


10. 

20, 

40, 

80, 

160, 

320, 

640); 


In  the  above  example  the  internal  representation  for  GREEN  will  be  the  integer  80.  The  attributes 
"SUCC  and  ’PRED  will  still  return  YELLOW  and  AQUA.  Also  the  Ada  RM  defines  that  the  TOS 
attribute  shall  still  return  the  positional  value  of  the  enumeration  literal.  In  the  case  of  GREEN  the 
value  that  TOS  returns  will  be  3  and  not  80.  The  only  way  to  examine  the  internal  representation  of  the 
enumeration  literal  is  to  write  the  value  to  a  file  or  use  UNCHECKED_CONVERS10N  to  examine  the 
value  in  memory. 

Minimum  size  of  an  enumeration  type  or  subtype 

The  minimum  size  of  an  enumeration  subtype  is  the  minimum  number  of  bits  that  is  necessary  for 
representing  the  internal  codes  in  normal  binary  form. 

For  a  static  subtype,  if  it  is  a  null  range  its  minimum  size  is  1.  Otherwise,  define  m  and  M,  to  be  the 
smallest  and  largest  values  for  the  internal  codes  values  of  the  subtype.  The  minimum  size  L  u 
determined  as  follows:  For  m  >■  0,  L  is  the  smallest  positive  integer  such  that  M  <•  (2**L)-1,  this  is  an 
unsigned  representation.  For  m  <  0,  L  is  the  smallest  positive  integer  such  that  ~(2**(L-l))  <■  m  and  M 
<■  {2**(L- 1))- 1,  this  is  a  two’s  complement  signed  representation. 

EXAMPLE; 


type  COLOR  is  (RED,  ORANGE,  YELLOW,  GREEN,  AQUA,  BLUE,  VIOLET); 
--  The  minimum  size  of  COLOR  is  3  bits. 

•  subtype  SUNNY_COLOR  is  COLOR  range  ORANGE  ..  YELLOW; 

--  The  minimum  size  of  COLOR  is  2  bits. 

--  because  the  internal  code  for  YELLOW  is  2 
--  and  (2**1 )-1  <=  2  <=  (2**2)-l 

type  TEMPERATURE  is  (FREEZING,  COLD,  MILD,  WARM,  HOT); 
for  TEMPERATURE  use  (FREEZING  =>  -10, 

COLD  *>  0, 

MILD  =>  10, 

WARM  *>  20, 

HOT  *>  30); 

--  The  minimum  size  of  TEMPERATURE  is  6  bits 
--  because  with  six  bits  we  can  represent  signed 
--  integers  between  -32  and  31. 
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Size  of  an  enumeration  type 

When  no  size  specification  is  applied  to  an  enumeration  type,  the  objects  of  that  type  are  represented  as 
signed  machine  integers.  The  HP  9000  Senes  300  Computer  System  provides  8,  16  and  32  bit  integers, 
and  the  compiler  automatically  selects  the  smallest  signed  machine  integer  which  can  hold  all  of  the 
internal  codes  of  the  enumeration  type.  Thus  the  default  size  for  enumeration  types  with  128  or  less 
elements  is  8  bits,  the  default  size  for  enumeration  types  with  129  to  32768  elements  is  16  bits  and  the 
default  size  for  enumeration  types  with  more  than  32768  elements  is  32  bits. 

When  a  size  specification  is  applied  to  an  enumeration  type,  this  enumeration  type  and  all  of  its  subtypes 
has  the  size  specified  by  the  length  clause.  The  size  specification  must  of  course  specify  a  value  greater 
than  or  equal  to  the  minimum  size  of  the  type.  Note  that  if  the  size  specification  specfies  the  minimum 
size  and  none  of  the  internal  codes  are  negative  integers  then  the  internal  representation  will  be  that  of 
an  unsigned  type.  Thus  when  using  a  size  specification  of  8  bits  you  can  have  up  to  256  elements  in  the 
enumeration  type. 

If  the  enumention  type  is  used  in  an  array  or  record  definition  that  is  further  constrained  by  a  pragma 
PACK  or  a  record  representation  clause,  then  the  size  of  this  component  will  be  determined  by  the  pragma 
PACK  or  the  record  representation  clause.  This  allows  the  array  or  record  type  to  temporarily  overnde 
any  size  specification  that  may  have  applied  to  the  enumeration  type. 

The  HP  Ada  compiler  provides  a  complete  implementation  of  size  specifications.  Nevertheless,  since 
enumeration  values  are  coded  using  integers,  the  specified  length  cannot  be  greater  than  32  bits. 

Alignment  of  an  enumeration  type 

An  enumeration  type  is  byte  aligned  if  the  size  of  the  typ*  is  less  than  or  equal  to  8  bits,  otherwise  it  is 
word  aligned.  Word  alignment  is  2  byte  alignment,  or  1 6  bit  alignment.  Alignments  larger  than  this  are 
not  supported. 


F  4.2  Integer  Types 


Predefined  integer  types 

The  HP  9000  Series  300  Computer  System  provides  three  predefined  integer  types. 


type  SHORT_SHORT_INTEGER 
is  range  -{2**1) 
type  SHORT_INTEGER 

ia  range  -(2**15) 
type  IMTECER 

ia  range  -(2**31 ) 


(2**7)-1 ; 
(2**15)-1; 
(2**31 )-1 ; 


8  bit  signed 
16  bit  signed 
32  bit  signed 


An  integer  type  declared  by  a  declaration  of  the  form: 


B-20 


Implemeniation -Dependent  Characteristics 


type  T  is  range  L  ..  U; 

IS  implicitly  derived  from  a  predefined  integer  type.  The  compiler  automatically  selects  the  smallest 
predefined  integer  type  whose  range  contains  the  values  L  to  U  inclusive. 

Internal  codes  of  integer  values 

The  internal  codes  for  integer  values  are  represented  using  the  two’s  complement  binary  method.  The 
internal  code  used  to  represent  an  integer  value  is  the  same  as  the  integer  value  used  in  the  program  in  all 
cases. 

Minimum  size  of  an  integer  type  or  subtype 

The  minimum  size  of  an  integer  subtype  is  the  minimum  number  of  bits  that  is  necessary  for  representing 
the  internal  codes  of  the  subtype 

For  a  static  subtype,  if  it  is  a  null  range  its  minimum  size  is  1.  Otherwise,  define  m  and  M,  to  be  the 
smallest  and  largest  values  for  the  internal  codes  values  of  the  subtype.  The  minimum  size  L  is 
determined  as  follows:  For  m  >-  0,  L  is  the  smallest  positive  integer  such  that  M  <-  (2**L)-1,  this  is  an 
unsigned  representation.  For  m  <  0,  L  is  the  smallest  positive  integer  such  that  -(2**(L-1))  <■  m  and  M 
<■  (2**(L-1))-1,  this  is  a  two’s  complement  signed  representation. 

EXAMPLL 

type  MY  INT  is  range  0  . .  31 ; 

--  The  minimum  size  of  MY_INT  is  5  bits  using 
--  an  unsigned  representation 

subtype  SOME_INT  is  MY_IMT  range  5  ..  7; 

--  The  minimum  size  of  S0ME_INT  is  3  bits. 

--  The  internal  representation  of  7  requires  three 
--  binary  bits  using  an  unsigned  representation. 

subtype  DYNAMIC_INT  is  MY_INT  range  L  . .  U; 

--  Assuming  that  L  and  U  are  dynamic,  (i.e.  not  known  at  compile  time) 

--  The  minimum  size  of  DYNAMIC_INT  is  the  same  as  its  base  type, 

--  MY_INT,  which  is  5  bits. 

type  ALT_INT  is  range  -1  ..  16; 

--  The  minimum  size  of  MY_INT  is  6  bits, 

--  because  using  a  5  bit  signed  integer  we 

--  can  only  represent  numbers  in  the  range  -16  ..  15 

--  and  using  a  6  bit  signed  integer  we 

--  can  represent  numbers  in  the  range  -32  . .  31 

--  Since  we  must  represent  16  as  well  as  -1  the 

--  compiler  must  choose  a  6  bit  signed  representation 

Size  of  an  integer  type 

The  sizes  of  the  predefined  integer  types  SHORT _ SHORT _ INTEGER,  SHORT _ INTEGER  and 

INTEGER  are  respectively  8,  16  and  32  bits. 
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When  no  size  specification  is  applied  to  an  integer  type,  the  default  size  is  that  of  the  predefined  integer 
type  from  which  it  derives,  directly  or  indirectly. 

EXAMPLE; 


type  S  is  range  80  ..  100; 

--  Type  S  is  derived  from  SHORT_SHORT  INTEGER 
its  default  size  is  8  bits. 

type  M  is  range  0  . .  255; 

--  Type  M  is  derived  from  SHORT_INTEGER 
its  default  size  is  16  bits. 

type  Z  is  new  M  range  80  ..  100; 

—  Type  Z  is  indirectly  derived  from  SHORT_INTEGER 

its  default  size  is  16  bits. 

type  L  is  range  0  . .  99999; 

--  Type  L  is  derived  from  INTEGER 
its  default  size  is  32  bits. 

type  UNSIGNED  BYTE  is  range  0  ..  (2»*8)-1; 
for  UNSIGNED  BYTE 'SIZE  use  B; 

—Type  UNSICNED^BYTE  is  derived  from  SHORT_INTEGER 

—  its  actual  size  is  B  bits. 

type  UNSIGNED  WORD  is  range  0  ..  (2**16)-1; 
for  UNSIGNED  WORD'SIZE  use  16; 

—  Type  UNSICNED_WORD  is  derived  froe  INTEGER 
--  its  actual  size  is  16  bits. 


When  a  size  specification  is  applied  to  an  integer  type,  this  integer  type  and  all  of  its  subtypes  has  the  size 
specified  by  the  length  clause.  The  size  specification  must  of  course  specify  a  value  greater  than  or  equal 
to  the  minimum  size  of  the  type.  Note  that  if  the  size  specification  speefies  the  mimmum  size  and  the 
lower  bound  of  the  range  is  not  negative  thtn  the  internal  represenution  will  be  that  of  an  unsigned  type. 
Thus  when  using  a  size  specification  of  8  bits  you  can  represent  an  integer  range  from  0  to  255. 

Notice  that  the  use  of  a  size  specification  on  an  integer  type  allows  the  Ada  programmer  to  define 
unsigned  machine  integer  types.  The  compiler  fully  supports  unsigned  machine  integers  type  that  are 
either  8  bits  or  16  bits.  The  8  bit  unsigned  machine  integer  type  is  derived  from  the  16  bit  predefined 
type,  SHORT_INTEGER.  Using  the  8  bit  unsigned  integer  type  in  an  expression  would  result  it  being 
converted  to  the  predefined  16  bit  signed  type  for  use  in  the  expression.  This  same  method  also  applies  to 
the  1 6  bit  unsigned  machine  integer  type. 

The  Ada  language  however,  forbids  the  definition  of  an  unsigned  integer  type  that  has  a  greater  range 
than  the  largest  predefined  integer  type.  You  will  recall  that  INTEGER  is  the  largest  predefined  integer 
type,  and  it  is  represented  as  a  32  bit  signed  machine  integer.  Since  the  Ada  language  requires  predefined 
integer  types  to  be  symmetric  about  zero  (Ada  RM  3.  5.4),  it  is  not  possible  to  define  a  32  bit  unsigned 
machine  integer  type,  since  the  largest  predefined  integer  type,  INTEGER,  is  also  a  32  bit  type. 

If  the  integer  type  is  used  in  an  array  or  record  definition  that  is  further  constrained  by  a  pragma  PACK 
or  record  representation  clause,  then  the  size  of  this  component  will  be  determined  by  the  pragma  PACK 
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or  record  representation  clause.  This  allows  the  array  or  record  type  to  temporarily  override  any  size 
specification  that  may  have  applied  to  the  integer  type. 

The  HP  Ada  compiler  provides  a  complete  implementation  of  size  specifications.  Nevertheless,  since 
integers  are  coded  using  machine  integers,  the  specified  length  cannot  be  greater  than  32  bits 

Alignment  of  an  integer  type 

An  integer  type  is  byte  aligned  if  the  size  of  the  type  is  less  than  or  equal  to  8  bits,  otherwise  it  is  word 
aligned.  Word  alignment  is  2  byte  alignment,  or  16  bit  alignment.  Alignments  larger  than  this  are  not 
supported. 


F  4.3  Floating  Point  Types 


Predefined  floating  point  types 

The  HP  9000  Series  300  Computer  System  provides  two  predefined  floating  point  types. 


type  FLOAT  is  digits  6 

range  -(2.0  -  2. 0**(-23) )*(2. 0**127)  .. 

■*■(2.0  -  2. 0**(-23))*(2. 0**127) ; 

--  This  expresses  the  decimal  range  -3. 40282E^*-38  ..  3 . 40282E'*-38 

type  LONG  FLOAT  is  digits  15 

range  -(2.0  -  2. 0**(-51 ) )*(2. 0**1023)  .. 
■►(2.0  -  2.0**(-51))*(2.0**1023); 

--  This  expresses  the  decimal  range  -1 . 79769^r308  ..  1.79769-^308 


A  floating  point  type  declared  by  a  declaration  of  the  form; 


type  T  is  digits  D  [range  L  ..  U); 

IS  implicitly  derived  from  a  predefined  floating  point  type.  The  compiler  automatically  selects  the 
smallest  predefined  floating  point  type  whose  number  of  digits  is  greater  than  or  equal  to  D  and  which 
contains  the  values  L  to  U  inclusive. 

Internal  codes  of  floating  point  values 

In  the  program  generated  by  the  compiler,  floating  point  values  are  represented  using  the  IEEE  standard 
formats  for  single  precision  and  double  precision  floats. 

The  values  of  the  predefined  type  FLOAT  are  represented  using  the  single  precision  float  format.  The 

values  of  the  predefined  type  LONG _ FLOAT  are  represented  using  the  double  precision  float  format. 

The  values  of  any  other  floating  point  type  are  represented  in  the  same  way  as  the  values  of  the 
predefined  type  from  which  it  derives,  directly  or  indirectly. 

Minimum  size  of  a  floating  point  type  or  subtype 
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The  minimum  size  of  a  floating  point  subtype  is  32  bits  if  its  base  type  is  FLOAT  or  a  type  derived  from 
FLOAT;  it  is  64  bits  if  its  base  type  is  LONG _ FLOAT  or  a  type  derived  from  LONG_FLOAT. 

Size  of  a  floating  point  type 

The  sizes  of  the  predefined  floating  point  types  FLOAT  and  LONG _ FLOAT  are  respectively  32  and  04 

bits. 

The  size  of  a  floating  point  type  and  the  size  of  any  of  its  subtypes  is  the  size  of  the  predefined  type  from 
which  It  derives,  directly  or  indirectly. 

The  only  size  that  can  be  specified  for  a  floating  point  type  using  a  size  specification  is  its  default  size  (32 
or  64  bits) 

Alignment  of  a  floating  point  type 

A  floating  point  type  is  always  word  aligned.  Word  alignment  is  2  byte  alignment,  or  1 6  bit  alignment. 
Alignments  larger  than  this  are  not  supported. 


F  4.4  Fixed  Point  Types 


Predefined  fixed  point  types 

To  implement  fixed  point  types,  the  HP  9000  Series  300  Computer  System  provides  a  set  of  three 
anonymous  predefined  fixed  point  types  of  the  form; 


type  SHORT  FIXED  is  delta  D 

range  -( (2**7)eSMALL)  ..  +( (2**7) -1 )*SMALL) ; 
for  SHORT_FIXED'SMALL  use  SMALL; 

type  FIXED  is  delta  D 

range  -( (2**15)*SMALL)  ..  +( (2**15)-1 )*SMALL) ; 
for  FIXED'SMALL  use  SMALL; 

type  L0NC_FIXED  is  delta  D 

range  -( (2**31  )*SMALL)  ..  ■*•(  (2**31 ) -1  )*SMALL) ; 
for  LOHG_FIXED' SMALL  use  SMALL; 

--  In  the  above  type  defintions  SMALL  is  the  largest  power  of 
--  two  that  is  less  than  or  equal  to  D. 


A  fixed  point  type  declared  by  a  declaration  of  the  form: 


type  T  is  delta  D  range  L  ..  U; 

is  implicitly  derived  from  one  of  the  predefined  fixed  point  types.  The  compiler  automatically  selects  the 
smallest  predefined  fixed  using  the  following  method.  First  choose  the  largest  power  of  two  that  is  not 
greater  than  the  value  specified  for  the  delta,  to  use  as  SMALL.  Then  determine  the  ranges  for  the  three 
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predefined  fixed  point  types  using  the  value  obtained  for  SMALL.  Then  select  the  smallest  predefined 
fixed  point  type  whose  range  contains  the  values  L+SMALL  to  U-SMALL  inclusive. 

Notice  that  the  user  supplied  values  L  and  U  may  not  be  inside  the  range  of  the  compiler  selected  fixed 
point  type.  For  this  reason  it  is  recommended  that  the  values  used  in  a  fixed  point  range  constraint  be 
express  as  follows,  to  guarantee  that  the  values  of  L  and  U  are  representable  in  the  resulting  fixed  point 

type- 

type  ANY_FIXED  is  delta  D  range  L-D  ..  U+D; 

--  The  values  of  L  and  U  are  guaranteed  to  be 
--  representable  in  the  type  ANY  FIXED. 


Internal  codes  of  fixed  point  values 

The  internal  codes  for  fixed  point  values  are  represented  using  the  two’s  complement  binary  method,  with 
an  implied  decimal  point  in  a  fixed  location.  The  location  of  the  decimal  point  is  completely  determined 
by  the  value  of  "SMALL. 

Small  of  a  fixed  point  type 

The  HP  Ada  compiler  requires  that  the  value  assigned  to  ’SMALL  is  always  a  power  of  two.  This 
implementation  does  not  support  a  length  clause  that  specifies  a  ’SMALL  for  a  fixed  point  type  that  is  not 
a  power  of  two. 

If  a  fixed  point  type  does  not  have  a  length  clause  that  specifies  the  value  to  use  for  ’SMALL,  then  the 
value  of  ’SMALL  is  determined  by  the  compiler  according  to  the  rules  in  the  Ada  RM  section  3.  5.  9. 

Minimum  size  of  a  fixed  point  type  or  subtype 

The  minimum  size  of  a  fixed  point  subtype  is  the  minimum  number  of  binary  digits  that  is  necessary  to 
represent  the  values  in  the  range  of  the  subtype  using  the  ’SMALL  of  the  base  type. 

For  a  static  subtype,  if  it  is  a  null  range  its  minimum  size  is  1.  Otherwise,  define  s  and  S  to  be  the  bounds 
of  the  subtype,  define  m  and  M  to  be  the  smallest  and  greatest  model  numbers  of  the  base  type  and  let  i 
and  I  be  the  integer  representations  for  the  model  numbers  m  and  M.  The  following  axioms  hold; 


8  <=  m  <  M  <=  S 
m-T'BASE'SMALL  <=  s 
M+T' BASE 'SMALL  >*  S 
M  =  T' BASE 'LARGE 
i  =  ■  /  T' BASE 'SMALL 
I  «  M  /  T' BASE 'SMALL 


The  minimum  size  L  is  determined  as  follows;  For  i  >■  0,  L  is  the  smallest  positive  integer  such  that  I  <  = 
(2*»L)-1,  this  is  an  unsigned  representation.  For  i  <  0,  L  is  the  smallest  positive  integer  such  that 
-(2»*(L-1))  <=  i  and  I  <=  {2**  (L-1 )  )-1,  this  is  a  two’s  complement  signed  representation. 
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type  UP  is  delta  0.1  range  0.0  ..  100.0; 

--  The  value  used  for  'SMALL  is  0.0625 
--  The  minimum  size  of  UP  is  11  bits, 

--  seven  bits  before  the  decimal  point 
--  four  bits  after  the  decimal  point 
--  and  no  bits  for  the  sign. 

type  SP  is  delta  16.0  range  -400.0  ..  400.0; 

--  The  minimum  size  of  SP  is  6  bits, 

--  nine  bits  to  represent  the  range  0  to  511 

--  less  four  bits  by  the  implied  decimal  point  of  16.0 

--  and  one  bit  for  the  sign. 

subtype  UPS  is  UP  delta  4.0  range  0.0  ..  31.0; 

—  The  minimum  size  of  UPS  is  7  bits, 

—  five  bits  to  represent  the  range  0  to  31 

--  two  bits  for  the  small  of  0.25  from  the  base  type 
--  and  no  bits  for  the  sign. 

subtype  SFD  is  SP  range  X  ..  Y; 

--  Assuming  that  X  and  Y  are  not  static,  the  minimum  size 

—  of  SPO  is  6  bits,  (the  same  as  its  base  type) 


Size  of  a  fixed  point  type 

The  sizes  of  the  anonymous  predefined  fixed  point  types  SHORT_FIXED,  FIXED,  and  LONG _ FIXED 

are  respectively  8,  16  and  32  bits. 

When  no  size  specification  is  applied  to  a  fixed  point  type,  the  default  size  is  that  of  the  predefined  fixed 
point  type  from  which  il  derives,  directly  or  indirectly. 

EXAMPLE 


type  0  is  delta  0.01  range  0.00  ..  1.00; 

--  Type  0  is  derived  from  an  8  bit  predefined  fixed  point  type, 

--  its  default  size  is  8  bits. 

type  R  is  delta  0.01  range  0.00  ..  2.00; 

--  Type  R  is  derived  from  a  16  bit  predefined  fixed  point  type, 

--  its  default  size  is  16  bits. 

type  S  is  new  R  range  0.00  ..  1.00; 

--  Type  S  is  indirectly  derived  from  a  16  bit  predefined  fixed  point  type, 
--its  default  size  is  16  bits. 

type  SP  is  delta  16.0  range  -400.0  ..  400.0; 
for  SP'SIZE  use  6; 

--  Type  SP  is  derived  from  an  8  bit  predefined  fixed  point  type, 

--  its  actual  size  is  6  bits. 

type  UP  is  delta  0.1  range  0.0  ..  100.0; 
for  UP'SIZE  use  11; 
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--  Type  UF  is  derived  from  a  16  bit  predefined  fixed  point  type, 
--  its  actual  size  is  11  bits. 

--  The  value  used  for  'SMALL  is  0.0625 


When  a  size  specification  is  applied  to  a  fixed  point  type,  this  fixed  point  type  and  all  of  its  subtypes  has 
the  size  specified  by  the  length  clause.  The  size  specification  must  of  course  specify  a  value  greater  than 
or  equal  to  the  minimum  size  of  the  type.  Note  that  if  the  size  specification  specfies  the  minimum  size 
and  the  lower  bound  of  the  range  is  not  negative  then  the  internal  representation  will  be  that  of  an 
unsigned  type. 

If  the  fixed  point  type  is  used  in  an  array  or  record  definition  that  is  further  constrained  by  a  pragma 
PACK  or  record  representation  clause,  then  the  size  of  this  component  will  be  determined  by  the  pragma 
PACK  or  record  representation  clause.  This,  allows  the  array  or  record  type  to  temporarily  override  any 
size  specification  that  may  have  applied  to  the  fixed  point  type. 

The  HP  Ada  compiler  provides  a  complete  implementation  of  size  specifications.  Nevertheless,  since  fixed 
point  objects  are  coded  using  machine  integers,  the  specified  length  cannot  be  greater  than  32  bits. 

Alignment  of  a  fixed  point  type 

A  fixed  point  type  is  byte  aligned  if  the  size  of  the  type  is  less  than  or  equal  to  8  bits,  otherwise  it  is  word 
aligned.  Word  alignment  is  2  byte  alignment,  or  1 6  bit  alignment.  Alignments  larger  than  this  are  not 
supported. 

F  4.5  Access  Types 


Internal  codes  of  access  values 

In  the  program  generated  by  the  compiler,  access  values  are  represented  using  32  bit  machine  addresses. 

The  predefined  generic  function  UNCHECKED _ CONVERSION  can  be  used  to  convert  the  internal 

representation  of  an  access  value  into  any  other  32  bit  type.  Alternatively  the  internal  representation  of 
an  access  value  can  be  assigned  to  be  any  32  bit  value  using  the  generic  function 

UNCHECKED _ CONVERSION.  When  interfacing  with  externally  supplied  data  structures  it  may  be 

aeccessary  to  use  the  generic  function  UNCHECKED CONVERSION  to  convert  a  value  of  the  type 

SYSTE.M.  ADDRESS  into  the  internal  representation  of  an  access  value.  Programs  which  use 
UNCHECKED _ CONVERSION  in  this  manner  cannot  be  considered  portable. 

Collection  size  for  access  types 

A  length  clause  that  specifies  the  collection  size  is  allowed  for  an  access  type.  This  collection  size  applies 
to  all  objects  of  this  type  and  any  type  denved  from  this  type,  as  wpU  as  any  and  all  subtypes  of  these 
types.  Thus  a  length  clause  that  specifies  the  collection  size  is  only  allowed  for  the  original  base  type 
definition  and  not  for  any  subtype  or  derived  type  of  the  base  type. 

When  no  specification  of  collection  size  applies  to  an  access  type,  the  attribute  STORAGE _ SIZE  returns 

zero.  In  this  case  the  compiler  will  dynamically  manage  the  storage  for  the  access  type  and  it  is  not 
possible  to  determine  directly  the  amount  of  storage  available  in  the  collection  for  the  access  type. 
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The  recommended  format  of  a  collection  size  length  clause  is: 

U_NUM:  constant  :=  50; 

U_SIZE:  constant  :=  U'SIZE  /  SYSTEM . STORAGE_UN IT; 

—  The  constant  U  SIZE  should  also  be: 

1.  a  eultiple  of  two 

2.  greater  than  or  equal  to  four 

--  Additinally,  the  type  U  must  have  a  static  size 

type  P  is  access  U;  --  Type  U  is  any  non-dynamic  user  defined  type, 
for  P'STORAGE  SIZE  use  (U  SIZE*U  NUM)+4; 


In  the  above  example  we  have  specified  a  collection  size  that  is  large  enough  to  contain  50  objects  of  the 
type  U.  There  is  a  constant  overhead  of  four  bytes  for  each  storage  collection.  Since  the  collection 
manager  rounds  the  element  size  to  be  a  multiple  of  two  that  is  four  or  greater,  the  user  must  insure  that 

U _ SIZE  is  the  smallest  multiple  of  two  that  is  greater  than  or  equal  to  U'SIZE  and  is  greater  than  or 

equal  to  four. 

Minimum  size  of  an  access  type  or  subtype 
The  minimumum  size  of  an  access  type  is  always  32  bits. 

Size  of  an  access  type 

The  size  of  an  access  typ>e  is  32  bits,  the  same  as  its  minimum  size. 

The  only  size  that  can  be  specified  for  an  access  type  using  a  size  specification  is  its  usual  size  (32  bits). 
Alignment  of  an  access  type 

Am  access  type  is  always  word  aligned.  Word  alignment  is  2  byte  alignment,  or  1 6  bit  alignment. 
Alignments  larger  than  this  are  not  supported. 

F  4.6  Task  Types 


Internal  codes  of  task  values 

In  the  program  generated  by  the  compiler,  task  type  objects  are  represented  using  32  bit  machine 
addresses. 

Storage  for  a  task  activation 

A  length  clause  that  specifies  the  storage  size  to  be  reserved  for  a  task  activation  is  allowed  for  a  task 
type.  This  storage  size  applies  to  all  objects  of  this  type  and  any  task  type  derived  from  this  type.  Thus  a 
length  clause  that  specifies  the  storage  size  is  only  allowed  for  the  original  task  type  definition  and  not  for 
any  derived  task  type. 

A  task  storage  size  clause  is  most  often  used  to  control  the  amount  of  stack  space  that  each  task  recieves 
upon  activation.  The  storage  size  for  task  is  the  sum  of  a  fixed  size  pnvate  task  data  section  and  a 
varying  size  task  stack  section. 
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The  recommended  format  of  a  storage  size  length  clause  is: 

TASK_PRIVATE:  constant  3604; 

STACK:  constant  :=  3000; 

task  type  T  is  . . .  --  Type  T  is  a  user  defined  task  type, 

for  T'STORAGE  SIZE  use  STACK  +  TASK  PRIVATE; 


In  the  above  example  we  have  specified  a  storage  size  that  is  large  enough  for  a  task  element  with  3000 
bytes  of  stack  space.  There  is  a  constant  overhead  of  3604  bytes  for  each  task  element. 

Minimum  sire  of  an  task  type  or  subtype 

The  minimumum  size  of  an  task  type  is  always  32  bits. 

Size  of  an  task  type 

The  size  of  an  task  type  is  32  bits,  the  same  as  its  minimum  size. 

The  only  size  that  can  be  specified  for  an  task  type  using  a  size  specification  is  its  usual  size  (32  bits). 
Alignment  of  an  task  type 

A  task  type  is  always  word  aligned.  Word  alignment  is  2  byte  alignment,  or  16  bit  alignment 
Alignments  larger  than  this  are  not  supported. 


F  4.7  Array  Types 


Layout  of  an  array 

Each  array  is  allocated  in  a  contiguous  area  of  storage  units.  All  the  components  have  the  same  size.  A 
gap  may  exist  between  two  consecutive  components  (and  after  the  last  component).  All  the  gaps  have  the 
same  size. 


^ - 

1 

Izzz  1 

Izzzl 

^ - 

Component  Gap  Component  Gap  Component  Gap 


Array  component  size  and  pragma  PACK 

If  the  array  is  not  packed  the  size  of  each  component  is  the  size  of  the  component  type.  This  size  is  the 
default  size  of  the  component  type  unless  a  size  specification  applies  to  the  component  type. 

If  the  array  is  packed  and  the  array  component  type  is  neither  a  record  or  array  type  then  the  size  of  the 
component  is  the  minimum  size  of  the  component  type.  The  minimum  size  of  the  component  type  is  used 
even  if  a  size  specification  applies  to  the  component  type. 

Packing  the  array  has  no  effect  on  the  size  of  the  components  when  the  component  type  is  a  record  or 
array  type. 
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Examples; 

type  A  is  array (1.. 8)  of  BOOLEAN; 

--  The  component  size  of  A  is  the  default  size 
--  of  the  type  BOOLEAN:  8  bits. 

type  B  is  array(1..8)  of  BOOLEAN; 
pragma  PACK(B); 

--  The  component  size  of  8  is  the  minimum  size 
--  of  the  type  BOOLEAN;  1  bit. 

type  DECIMAL_DIGIT  is  range  0..9; 

--  The  default  size  for  DEC1MAL_DIGIT  is  8  bits 
--  The  minimum  size  for  DECIMAL_DIGIT  is  4  bits 

type  BCD_HOT_PACKED  is  array (1.. 8)  of  DECIMAL_DIGIT; 

--  The  component  size  of  BCO_NOT_PACKED  is  the  default 

—  size  of  the  type  DECIMAL_DICIT:  8  bits. 

type  BCD  PACKED  is  array (1.. 8)  of  DECIMAL  DIGIT; 
pragma  PACK ( BCD_PACKED ) ; 

—  The  component  size  of  BCD_PACKED  is  the  minimum 

—  size  of  the  type  DECIMAL  DIGIT:  4  bits. 


Array  gap  size  and  pragma  PACK 

If  the  array  type  is  not  packed  and  the  component  type  is  a  record  type  without  a  size  specification  clause 
then  the  compiler  may  choose  a  representation  for  the  array  with  a  gap  after  each  component.  The  aim 
of  the  compiler  in  the  insertion  of  such  gaps  is  to  optimize  access  to  the  array  components.  The  size  of  the 
gap  is  choosen  so  that  the  each  array  component  begins  on  an  alignment  boundry. 

If  the  array  type  is  packed  then  the  compiler  will  not  insert  a  gap  between  the  array  componenti  In  this 
case  access  to  array  components  can  be  slower  since  the  array  components  will  not  always  be  aligned 
correctly. 
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Examples: 

type  R  is 
record 

K  :  INTEGER;  --  Type  Integer  is  word  aligned. 

B  :  BOOLEAN;  --  Type  Boolean  is  byte  aligned, 

end  record; 

--  Record  type  R  is  word  aligned.  Its  size  is  40  bits, 
type  A  is  array(1..10)  of  R; 

--  A  gap  of  one  byte  is  inserted  after  each  array  component  in 
--  order  to  respect  the  alignment  of  type  R. 

--  The  size  of  array  type  A  is  480  bits. 

type  PA  is  array(1..10)  of  R; 
pragma  PACK(PA); 

--  There  are  no  gaps  in  an  array  of  type  PA  because 
--  of  the  pragma  PACK  statement  on  type  PA. 

--  The  size  of  array  type  PA  is  400  bits. 

type  NR  is  new  R; 
for  NR'SIZE  use  40; 

type  B  is  array(1..10)  of  HR; 

--  There  are  no  gaps  in  an  array  of  type  B  because 
--  of  the  size  specification  clause  on  type  NR. 

—  The  size  of  array  type  B  is  400  bits. 


Size  of  an  array  type  or  subtype 

The  size  of  an  array  subtype  is  obtained  by  multiplying  the  number  of  its  components  by  the  sum  of  the 
size  of  the  component  and  the  size  of  the  gap. 


The  size  of  an  array  type  or  subtype  cannot  be  computed  at  compile  time: 

o  if  it  has  non-static  constraints  or  if  it  is  an  unconstrained  type 
with  non-static  index  subtypes  (because  the  number  of  components 
can  then  only  be  determined  at  run  time). 

o  if  the  components  are  records  or  arrays  and  their  constraints 

or  the  constraints  of  their  subcomponents  are  not  static  (because 
the  size  of  the  components  and  the  size  of  the  gaps  can  then  only 
be  determined  at  run  time).  Pragma  PACK  is  not  allowed  in  this 
case. 


As  has  been  indicated  above,  the  effect  of  a  pragma  PACK  on  an  array  type  is  to  suppress  the  gaps  and  to 
reduce  the  size  of  the  components,  if  possible.  The  consequence  of  packing  an  array  type  is  thus  to  reduce 
its  size. 

If  the  components  of  an  array  type  are  records  or  arrays  and  their  constraints  or  the  constraints  of  their 
subcomponents  are  not  static,  the  compiler  ignors  any  pragma  PACK  statement  applied  to  the  array  type 
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and  instead  issues  a  warning  message.  Apart  from  this  limitation  array  packing  is  fully  implemented  by 
the  HP  Ada  compiler. 

A  size  specification  applied  to  an  array  type  has  no  effect.  The  only  size  that  the  compiler  will  accept  in 
such  a  length  clause  is  the  usual  size.  Nevertheless,  such  a  length  clause  can  be  used  to  venfy  that  the 
layout  of  an  array  is  as  expected  by  the  application. 

Alignment  of  an  array  type 

If  no  pragma  PACK  applies  to  an  array  type  and  no  size  specification  applies  to  the  component  type,  the 
array  type  is  word  aligned  if  the  component  type  is  word  aligned.  Otherwise  it  is  byte  aligned. 

If  a  pragma  PACK  applies  to  an  array  type  or  if  a  size  specifiaction  applies  to  the  component  type  (so  that 
there  are  no  gaps),  the  alignment  of  the  array  type  is  as  given  in  the  following  table: 


relative  displacament  of  componants 

•van  nufflbar  odd  numbar  not  a  whola 
of  bytes  of  bytes  number  of  bytes 


Component 

word 

word 

byte 

bit 

subtype 

byte 

byte 

byte 

bit 

alignment 

bit 

bit 

bit 

bit 

F  4.6  Record  Types 


Layout  of  a  record 

A  record  is  allocated  in  a  contigous  area  of  storage  units.  The  size  of  a  record  depends  of  the  size  of  its 
components  and  the  size  of  any  gaps  between  the  components.  The  compiler  may  add  additional 
components  to  the  record.  These  compionents  are  called  implicit  components. 

The  positions  and  sizes  of  the  components  of  a  record  type  object  can  be  controlled  using  a  record 
representation  clause  as  described  in  the  Ada  RM  1  3. 4.  If  the  record  contains  compiler  generated  implicit 
components  their  position  also  can  be  controlled  using  the  proper  record  component  clause.  In  the 
implementation  for  the  HP  9000  Series  300  Computer  System  there  is  no  restriction  on  the  position  that 
can  be  specified  for  a  component  of  a  record.  If  the  component  is  not  a  record  or  an  array,  its  size  can  be 
any  size  from  the  minimum  size  to  the  default  size  of  its  base  type.  If  the  component  is  a  record  or  an 
array,  its  size  must  be  the  size  of  its  base  type. 
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Example  of  a  record  representation  clause; 

type  TRACE_KIND  is  (None,  Change_of_riow,  Any_Inst ruct ion ,  Reserved); 

type  SYSTEM_STATE  is  (User,  Supervisor); 

type  SUPERVISOR  STATE  is  (Interrupt,  Master); 

type  INTERRUPT  PRIORITY  is  range  0--7; 

type  CONDITION  CODE  is  new  BOOLEAN; 
for  CONDITION_CODE'SIZE  use  1; 

SYSTEM_BYTE  :  constant  :*  0; 

USER^BYTE  :  constant  :»  1; 

type  STATUS_REGISTER  is 
record 

T  :  TRACE  KIND; 

S  :  SYSTEM  STATE; 

M  :  SUPERVISOR  STATE; 

I  :  INTERRUPT  PRIORITY; 

X  :  CONDITION'cODE; 

N  :  CONDITION”cODE; 

Z  :  CONDITION”cODE; 

V  :  CONDITION”cODE; 

C  ;  C0NDITI0N~C0DE; 
end  record; 

—  This  type  can  be  used  to  map  the  status  register  of 
--  the  MC68020  microprocessor. 


for  STATUS_REGISTER  use 
record  at  mod  2; 

T  at  SYSTEM  BYTE  range 
S  at  SYSTEM~BYTE  range 
M  at  SYSTEM“byTE  range 
I  at  SYSTEM“byTE  range 
X  at  USER_BYTE  range 
N  at  USER_BYTE  range 
Z  at  USER  BYTE  range 
V  at  USER”BYTE  range 
C  at  USER“byTE  range 
end  record; 


0. .  1 
2.  .2 
3.  .3 
5.  ,7 

3.  .3 

4.  .4 

5.  .5 

6.  .6 
7.  .7 


In  the  above  example  we  have  used  a  record  representation  clause  to  explictly  tell  the  compiler  both  the 
position  and  size  for  each  of  the  record  components.  In  this  example  we  supplied  the  optional  alignment 
clause,  which  specified  a  word  alignment  for  this  record.  In  this  example  every  component  has  a 
corresponding  component  clause.  It  is  not  required  that  every  component  have  a  corresponding 
component  clause,  if  one  is  not  supplied  then  the  choice  of  the  storage  place  for  that  component  is  left  to 
the  compiler.  If  component  clauses  are  given  for  all  components,  the  record  representation  clause 
completely  specifies  the  representation  of  the  record  type  and  will  be  obeyed  exactly  by  the  compiler. 
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Bit  ordering  in  a  record  coeponent  clause 

The  HP  Ada  compiler  for  the  HP  9000  Senes  300  Computer  System  numbers  the  bits  in  a  record 
representation  clause  starting  from  the  most  significant  bit.  Thus  bit  0  represents  the  most  significant  bit 
of  an  eight  bit  byte  and  bit  7  represents  the  least  significant  bit  of  the  byte.  Notice  that  this  ordering  is 
different  than  the  bit  ordering  used  in  the  Motorola  MC68020  User's  Manual,  which  numbers  the  bits  in 
the  reverse  manner. 

Ik. 

Value  used  for  SYSTEM.STORAGE_UNIT 

The  smallest  directly  addressable  unit  on  the  HP  9000  Series  300  Computer  System  is  the  8  bit  byte.  This 

is  the  value  used  for  SYSTEM.  STORAGE _ UNIT  v/hich  is  implicitly  used  in  a  record  representation 

clause.  A  record  representation  component  clause  specifies  an  offset  and  a  bit  range.  The  offset  in  a 

component  clause  is  measured  in  units  of  SYSTEM. STORAGE _ UNIT,  which  for  the  HP  9000  Series  300 

Computer  System  is  a  byte. 

The  compiler  determines  the  actual  bit  address  for  a  record  component  by  combining  the  (byte)  offset 
with  the  bit  range.  The  are  several  different  ways  to  refers  to  the  same  bit  address.  In  the  follc'»  :ng 
example  each  of  the  record  component  clauses  refer  to  exactly  the  same  bit  address. 


COMPONENT  at  0  rang*  16  ..  18; 

COMPONENT  at  1  range  8  ..  10; 

COMPONENT  at  2  range  0  ..  2; 


Compiler  chosen  record  layout 

If  no  component  clause  applies  to  a  component  of  a  record,  its  size  is  the  default  size  of  the  base  type.  Its 
location  in  the  record  layout  is  chosen  by  the  compiler  so  as  to  optimize  access  to  the  component.  The 
offset  is  chosen  to  be  a  multiple  of  8  bits  if  the  object  is  normally  byte  aligned,  and  is  chosen  to  be  a 
multiple  of  1 6  bits  if  the  object  is  normally  word  aligned.  Moreover,  the  compiler  chooses  the  position  of 
the  components  so  as  to  reduce  the  number  of  gaps  and  thus  the  size  of  the  record  object. 

Because  of  these  optimizations,  there  is  no  connection  between  the  order  of  the  components  in  a  record 
type  declaration  and  the  positions  chosen  by  the  compiler  for  the  components  in  a  record  object. 

In  the  current  version  of  the  compiler,  it  is  not  possible  to  apply  a  record  representation  clause  to  a 
derived  record  type.  The  compiler  will  use  the  same  storage  representation  for  all  records  of  the  same 
base  type.  Thus  the  compiler  does  not  support  the  "Change  in  Representation"  as  describe  in  the  Ada  RM 
13.6. 
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Implicit  components 

In  some  circumstances,  access  to  a  record  object  or  to  a  component  of  a  record  object  involves  computing 
information  which  only  depends  on  the  discriminant  values  or  on  a  value  that  is  known  only  at  run  time. 
To  avoid  useless  recomputation  the  compiler  reserves  space  in  the  record  to  store  this  information.  The 
compiler  will  update  this  information  whenever  a  discriminant  on  which  it  depends  changes.  The 
compiler  uses  this  information  whenever  the  component  that  depends  on  this  information  is  accessed. 
This  information  is  stored  in  special  components  called  implicit  components.  There  are  three  different 
kinds  of  implicit  components. 

Implicit  components  that  contain  an  offset  value  from  the  beginning  of  the  record  are  used  to  access 
indirect  components.  Implicit  components  of  this  kind  are  called  OFFSET  components.  The  compiler 
introduces  implicit  OFFSET  components  whenever  a  record  contains  indirect  components.  These  implicit 
components  are  considered  to  be  declared  before  any  variant  part  in  the  record  type  defintion.  Implicit 
components  of  this  kind  cannot  be  suppressed  by  using  the  pragma  IMPROVE. 

Implicit  components  that  contain  information  about  the  record  object  art  used  when  the  record  object  or 
component  of  a  record  object  is  accessed.  Implicit  components  of  this  kind  are  used  to  make  references  to 
the  record  object  or  record  components  more  effecient.  These  implicit  components  are  considered  to  be 
declared  before  any  variant  part  in  the  record  type  defintion.  There  are  two  implicit  components  of  this 

kind;  one  is  called  RECORD _ SIZE  the  other  is  called  VARIANT _ INDEX.  Implicit  components  of  this 

kind  can  be  suppressed  by  using  the  pragma  IMPROVE. 

The  third  kind  of  implicit  components  are  descriptors  that  are  used  when  accessing  a  record  component. 
For  this  case  the  implicit  component  exists  whenever  the  record  component  that  depends  on  it,  exists.  An 
implicit  component  of  this  kind  is  considered  to  be  declared  immediately  before  the  record  component  on 
which  it  depends.  There  are  two  implicit  components  of  this  kind;  one  is  called  ARRAY_DESCRlPTOR 
other  is  called  RECORD_DESCRIPTOR.  Implicit  components  of  this  kind  cannot  be  suppressed  by  using 
the  pragma  IMPROVE. 


NOTE 


Note;  The  "-S"  parameter  (Assembly  Option)  to  the  "ada(l)"  command  is 
very  useful  for  finding  out  what  implicit  components  are  associated  with 
the  record  type.  This  option  will  detail  the  exact  representation  for  all 
record  types  defined  in  a  compilation  unit. 


Indirect  components 

If  the  offset  of  a  component  cannot  be  computed  at  compile  time,  the  compiler  will  reserve  space  in  the 
record  for  the  computed  offset.  The  compiler  will  compute  the  value  to  be  stored  in  this  offset  at  run 
time.  A  component  that  depends  on  a  run  time  computed  offset  is  said  to  be  an  indirect  component,  while 
other  components  are  said  to  be  direct. 


Figure,  Direct  &  Indirect  Components 


If  a  record  component  is  a  record  or  an  array,  the  size  of  the  component  may  need  to  be  computed  at  run 
time  and  may  even  depend  on  the  discriminants  of  the  record.  We  will  call  these  components  dynamic 
components. 
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Example  of  a  record  with  dynamic  components: 

type  LI_RNG  is  range  0..255; 

type  UC_ARRAY  is  array(U_RNC  range  <>)  of  INTEGER; 

--  The  type  GRAPH  has  two  dynamic  components:  X  and  Y. 

type  GRAPH  (X_LEN,  Y_LEN :  U_RNC)  is 
record 

X  :  UC_ARRAY ( 1  ..  X_LEN);  --  The  size  of  X  depends  on  X_LEN 
Y  :  UC  ARRAY ( 1  ..  Y_LEN);  —  The  sire  of  Y  depends  on  Y_LEN 
end  record; 

type  DEVICE  is  (SCREEN,  PRINTER); 
type  COLOR  is  (GREEN,  RED,  BLUE); 

Q  :  U  RNG; 


—  The  type  PICTURE  has  two  dynamic  components:  R  and  T. 

type  PICTURE  (N  :  U_RNG;  D  :  DEVICE)  is 
record 

R  :  GRAPH (N,N);  —  The  «ize  of  R  depends  on  N 
T  :  GRAPH(Q,Q);  —  The  sire  of  T  depends  on  0 
case  D  is 

when  SCREEN  => 

C  ;  COLOR; 
when  PRINTER  => 
null ; 
end  case; 
end  record; 


Any  component  that  is  placed  after  a  dynamic  component  has  an  offset  that  cannot  be  evaluated  at 
compile  time  and  is  thus  indirect.  In  order  to  minimize  the  number  of  indirect  components,  the  compiler 
groups  the  dynamic  components  together  and  places  them  at  the  end  of  the  record. 

Thanks  to  this  stratagy,  the  only  indirect  components  are  dynamic  components.  But  not  all  dynamic 
components  are  neceaarily  indirect,  the  compiler  can  u.sually  compute  the  offset  of  the  first  dynamic 
component  and  thus  it  becomes  a  direct  component,  any  additional  dynamic  components  are  then  indirect 
components. 
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A  pictorial  example  of  the  data  layout  for  the  record  type  PICTURE. 
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Representation  of  the  offset  of  an  indirect  component 

The  offset  of  an  indirect  component  is  always  expressed  in  storage  units,  which  for  the  HP  9000  Series 
300  Computer  System  are  bytes.  The  space  that  the  compiler  reserves  for  the  offset  of  an  indirect 
component  must  be  large  enough  to  store  the  maximum  potential  offset.  The  compiler  will  choose  the  size 
of  the  offset  components  to  be  either  8  bit,  16  bit  or  32  bit  objects.  It  is  possible  to  further  reduce  the 
size  in  bits  of  this  component  by  specifying  it  in  a  record  component  clause. 

If  C  is  the  name  of  an  indirect  component,  then  the  offset  of  this  component  can  be  denoted  in  the  record 
representation  clause  by  the  implementation  generated  name  C’OFFSET. 

An  example  record  representation  clause  for  the  type  GRAPH; 

for  GRAPH  use 
record 

X_LEN  at  0  range  0..7; 

Y_LEN  at  1  range  0..7; 

X 'OFFSET  at  2  range  0..15; 
end  record; 

--  The  bit  range  range  for  the  implicit  component 
--  X'OFFSET  could  have  been  specified  as  0..11 
--  This  would  eake  access  to  X  much  slower 


In  this  example  we  have  used  a  component  clause  to  specify  the  location  of  an  offset  for  a  dynamic 
component.  In  this  example  the  compiler  will  chose  Y  to  be  first  dynamic  component  and  as  such  it  will 
have  a  static  offset.  The  component  X  will  be  placed  immediately  after  the  end  of  component  Y  by  the 
compiler  at  run  time.  At  run  time  the  compiler  will  store  the  offset  of  this  location  in  the  field 
X’OFFSET.  Any  references  to  X  will  have  an  additional  code  to  compute  the  run  time  address  of  X,  using 
the  X’OFFSET  field.  References  to  Y  will  be  direct  references. 

The  implicit  component  RECORD  SIZE 
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This  implicit  component  is  created  by  the  compiler  whenever  a  discriminant  record  type  has  a  variant 
part  and  its  discriminants  are  not  defaulted.  It  contains  the  size  of  the  storage  space  required  to  represent 
the  current  variant  of  the  record  object.  Note  that  the  storage  effectively  allocated  for  the  record  object 
may  be  more  than  this. 

The  value  of  a  RECORD _ SIZE  component  may  denote  a  number  of  bits  or  a  number  of  storage  units 

(bytes).  In  most  cases  it  denotes  a  number  of  storage  units  (bytes),  but  if  any  component  clause  specifies 
that  a  component  of  the  record  type  has  an  offset  or  a  size  which  cannot  be  express  using  storage  units, 
then  the  value  designates  a  number  of  bits. 

The  implicit  component  RECORD _ SIZE  must  be  large  enough  to  store  the  maximum  size  that  the  record 

type  can  attain.  The  compiler  evaluates  this  size,  calls  it  MS  and  considers  the  type  of  RECORD_SIZE  to 
be  an  anonymous  integer  type  whose  range  is  0  . .  MS 

If  R  is  the  name  of  a  record  type,  then  this  implicit  component  can  be  denoted  in  a  record  representation 
clause  by  the  implementation  generated  name  RHECORD _ SIZE. 

The  implicit  component  VARIANT^INOEX 

This  implicit  component  is  created  by  the  compiler  whenever  the  record  type  has  a  variant  part.  It 
indicates  the  set  of  components  that  are  present  in  a  record  object.  It  is  used  when  a  discriminate  check  is 
to  be  done. 

Within  a  variant  part  of  a  record  type,  the  compiler  numbers  component  lists  that  themselves  do  not 
contain  a  variant  part.  These  numbers  are  the  possible  values  of  the  implicit  component 

Variant _ index.  The  compiler  uses  this  number  to  determine  which  components  of  the  variant 

record  are  currently  valid. 


typa  VEHICLE  is  (AIRCRAFT,  ROCKET,  BOAT,  CAR); 

type  DESCRIF»TION(  KIND  :  VEHICLE  :*  CAR)  is 
record 

SPEED  :  INTEGER; 
case  KIND  is 

when  AIRCRAFT  |  CAR  => 

WHEELS  :  INTEGER; 
case  KIND  is 

when  AIRCRAFT  =>  --  VARIANT  INDEX  is  1 

WINGSPAN  :  INTEGER; 

when  others  =>  --  VARIANT_INDEX  is  2 

null ; 
end  case; 

when  BOAT  =>  --  VARIANT  INDEX  is  3 

STEAM  :  BOOLEAN; 

when  ROCKET  =>  —  VARIANT_INDEX  is  4 

STAGES  :  INTEGER; 
end  case; 
end  record; 


In  the  above  example  the  value  of  the  variant  index  indicates  which  of  the  components  are  present  in  the 
record  object. 
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Variant  Index  Legal  Components 


1  KIND,  SPEED,  WHEELS,  WINGSPAN 

2  KIND,  SPEED,  WHEELS 

3  KIND,  SPEED,  STEAM 

4  KINO,  SPEED,  STAGES 


The  implicit  component  VARIANT _ INDEX  must  be  large  enough  to  store  the  number  of  component  lists 

that  don’t  contain  variant  parts.  The  compiler  evaluates  this  size,  calls  it  VS  and  considers  the  type  of 
VaRIANT_INDEX  to  be  an  anonymous  integer  type  whose  range  is  0  ..  VS. 

If  R  is  the  name  of  a  record  type,  then  this  implicit  component  can  be  denoted  in  a  record  representation 
clause  by  the  implementation  generated  name  RVARIaNT _ INDEX. 

Tha  implicit  component  ARRAY_DESCRIPTOR 

An  implicit  component  of  this  kind  is  associated  r.  /  the  compiler  with  each  record  component  whose  type 
is  an  array  which  has  bounds  that  depend  on  a  discrimant  of  the  record. 

The  structure  and  contents  of  an  implicit  component  of  the  kind  ARRAY _ DESCRIPTOR  is  not  described 

in  this  document.  Nevertheless,  if  a  programmer  is  interested  in  specifying  the  location  of  a  component  of 
this  kind  using  a  component  clause,  he  can  obtain  the  size  of  the  component  using  the  "-S"  parameter 
(Assembly  Option)  to  the  "ada(  1 )"  command. 

If  C  is  the  name  of  a  record  component,  which  conforms  to  the  above  definition,  then  this  implicit 
component  can  be  denoted  in  a  record  representation  clause  by  the  implementation  generated  name 
C’ARRAy_DESCRIPTOR. 

The  inplicit  component  RECORD_DESCRIPTOR 

An  implicit  component  of  this  kind  may  be  associated  by  the  compiler  when  a  record  component  is  a 
record  type  which  has  components  whose  size  depends  on  a  discnmant  of  the  outer  record. 

The  structure  and  contents  of  an  implicit  component  of  the  kind  RECORD_DE5CRIPTOR  is  not 
described  in  this  document.  Nevertheless,  if  a  programmer  is  interested  in  specifying  the  location  of  a 
component  of  this  kind  using  a  component  clause,  he  can  obtain  the  size  of  the  component  using  the  "-S" 
parameter  (Assembly  Option)  to  the  "adadT  command. 

If  C  is  the  name  of  a  record  component,  which  conforms  to  the  above  definition,  then  this  implicit 
component  can  be  denoted  in  a  record  representation  clause  by  the  implementation  generated  name 
C’RECORD_DESCRIPTOR. 

Suppression  of  implicit  components 

The  HP  Ada  implementation  provides  the  capability  of  suppressing  the  implicit  components 

RECORD _ SIZE  and  VARIANT _ INDEX  from  a  record  type.  This  can  be  done  using  an  implementation 

defined  pragma  called  IMPROVE.  The  syntax  of  this  pragma  is  as  follows; 


pragma  IMPROVE  (  TIME  |  SPACE  ,  [ON  =>]  record  type_name  ); 
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The  first  argument  specifies  whether  TIME  or  SPACE  is  the  primary  criterion  for  the  choice  of 
representation  of  the  record  type  that  is  denoted  by  the  second  argument. 

If  TIME  is  specified,  the  compiler  inserts  implicit  components  as  described  above.  This  is  the  default 
behavior  of  the  compiler.  If  on  the  other  hand  SPACE  is  specified,  the  compiler  only  inserts  a 

VARIANT INDEX  or  a  RECORD SIZE  component  if  this  component  appears  in  the  record 

representation  clause  for  the  record  type.  If  the  record  type  has  no  record  representation  clause  then  both 
components  will  be  suppressed.  A  record  representation  clause  can  be  used  to  keep  one  implicit 
component  while  suppressing  the  other. 

A  pragma  IMPROVE  that  applies  to  a  given  record  type  can  occur  anywhere  that  a  record  representation 
clause  is  allowed  for  this  type. 

Size  of  a  record  type  or  subtype 

The  compiler  generally  will  round  upwards  the  size  of  a  record  type  to  a  whole  number  of  storage  units 
(bytes).  If  the  record  type  has  a  record  representation  clause  which  specifies  a  record  component  that 
cannot  be  expressed  in  storage  units  then  the  compiler  will  not  round  upwards  and  instead  the  record  size 
will  be  expressed  as  an  exact  number  of  bits. 

The  size  of  a  constrained  record  type  is  obtained  by  adding  the  sizes  of  its  components  and  the  sizes  of  its 
gaps  (if  any).  The  size  of  a  constrained  record  will  not  be  computed  at  compile  time: 

o  when  the  record  type  has  non-static  constraints, 

o  when  a  component  is  an  array  or  record  and  its  size 
cannot  be  computed  at  coepile  time.  (i.e.  if  the 
component  has  non-static  constraints) 


The  size  of  an  unconstrained  record  type  is  obtained  by  adding  the  sizes  of  the  components  and  the  sizes  of 
the  gaps  (if  any)  of  the  largest  variant.  If  the  size  of  any  component  cannot  be  evaluated  exactly  at 
compile  time,  the  compiler  will  use  the  maximum  size  that  the  component  could  possibly  assume,  to 
compute  the  size  of  the  unconstrained  record  type. 

A  size  specification  applied  to  an  record  type  has  no  effect.  The  only  size  that  the  compiler  will  accept  in 
such  a  length  clause  is  the  usual  size.  Nevertheless,  such  a  length  clause  can  be  used  to  venfy  that  the 
layout  of  an  record  is  as  expected  by  the  application. 

Size  of  an  object  of  a  record  type 

A  record  object  of  a  constrained  record  type  has  the  same  size  as  its  base  type. 

A  record  object  of  an  unconstrained  record  type  has  the  same  size  as  its  base  type  if  this  size  is  less  than  or 
equal  to  8192  bytea.  If  the  size  of  the  base  type  is  larger  than  this,  the  record  object  has  the  size  necessary 
to  store  its  current  value;  storage  space  is  allocated  and  released  as  the  discriminants  of  the  record  change. 

Alignment  of  a  record  subtype 

When  no  record  representation  clause  applies  to  its  base  type,  record  subtype  is  word  aligned  if  it 
containds  a  component  whose  type  is  word  aligned.  Word  alignment  is  ?  byte  alignment,  or  1 6  bit 
alignment.  Otherwise  the  record  type  is  byte  aligned. 


B-40 


Implementation -Dependent  Characteristics 


When  a  record  representation  clause  that  does  not  contain  an  alignment  clause  applies  to  its  base  type,  the 
record  subtype  is  word  aligned  if  it  contains  a  component  whose  type  is  word  aligned  and  whose  offset  is 
also  word  aligned.  Otherwise  the  record  subtype  is  byte  aligned. 

When  a  record  representation  clause  that  contains  an  alignment  clause  applies  to  its  base  type,  a  record 
subtype  also  obeys  the  alignment  clause.  An  alignment  clause  can  specify  that  a  record  type  is  byte 
aligned  or  word  aligned.  Alignments  larger  than  this  are  not  supported. 

F  5.2  Names  for  Predefined  Library  Units 

The  following  names  are  used  by  the  HP  Ada  Compilation  System.  Do  not  use  any  of  these  names  for 
your  library-level  Ada  units. 


HIT 

MATH  EXCEPTIONS  * 

math”lib  * 
unix'env  * 

The  packages  whose  names  are  followed  by  •  are  available  to  be  used  in  your 
programs.  These  packages  are  documented  in  the  Ada  User's  Guide. 

F  6.  ADDRESS  CLAUSES 

Address  Clauses  for  Objects 

An  address  clause  can  be  used  to  specify  an  address  for  an  object  as  described  in  the  Ada  RM  1 3.  5.  When 
such  a  clause  applies  to  an  object  no  storage  is  allocated  for  it  in  the  program  generated  by  the  compiler. 
The  program  accesses  the  object  by  using  the  address  specified  in  the  address  clause. 

An  address  clause  is  not  allowed  for  task  objects,  nor  for  unconstrained  records  whose  maximum  size  can 
be  greater  than  8192  bytes. 

Address  Clauses  for  Subprograms 

Address  clauses  for  subprograms  are  not  implemented  in  the  current  version  of  the  HP  Ada  compiler. 
Address  Clauses  for  Task  Entries 

Address  clauses  for  task  entries  are  not  implemented  in  the  current  version  of  the  HP  Ada  compiler. 


F  7.  Restrictions  on  Unchecked  Type  Conversions 

The  following  limitations  apply  to  the  use  of  UNCHECKED _ CONVERSION: 


B-41 


ImplemenU  non  -Impendent  Characteristics 


o  Unconst  rained  arrays  are  not  allowed  as  target  types, 
o  Unconstrained  record  types  without  defaulted  default  discriminants 
are  not  allowed  as  targets  types, 
o  Access  types  to  unconstrained  arrays  are  not  allowed  as  source 
or  target  types . 

o  If  the  source  and  target  types  are  each  scalar  types  the  sizes  of 
the  types  nust  be  equal. 

o  If  the  source  and  target  types  are  each  access  types  the  sizes  of 
the  objects  which  the  types  denote  must  be  equal. 


If  the  source  and  the  target  types  are  each  scalar  or  access  types  or  if  they  are  both  composite  types,  the 
effect  of  the  function  is  to  return  the  operand. 

In  other  cases,  the  effect  of  unchecked  conversion  can  be  considered  as  a  copy. 


WARNING 


When  you  do  an  UNCHECKED_CONVERSION  among  types  whose  sizes  do  not 
match,  the  code  which  is  generated  copies  as  many  byes  as  necessary  from 
the  source  location  to  fill  the  target.  If  the  target  is  larger  than  the 
source,  the  code  copies  all  of  the  source  plus  whatever  happens  to  follow 
the  source.  So  an  UNCHECKED_CONVERSION  among  types  whose  sizes  do 
not  match  can  produce  meaningless  results,  or  actually  cause  a  trap  and 
abort  the  program  (if  these  memory  locations  do  not  actually  exist). 
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F  8.  Implementation-Dependent  Input-Output  Characteristics 

Section  8  covers  the  input/output  (I/O)  characteristics  of  Ada  on  the  HP  dOOO  Senes  300  computer  Ada 
handles  I/O  with  packages,  which  are  discussed  in  Section  F  8.  1.  File  types  are  covered  m  Section  F 
8  1.3.  The  FORM  parameter  is  discussed  in  detail  in  Section  F  8.  2. 

F  8.1  Ada  I/O  Packages  for  External  Files 

I/O  operations  are  considered  to  be  performed  on  objects  of  a  specific  file  type,  rather  than  being 
performed  directly  on  external  files.  An  external  file  is  a  file  external  to  the  program  that  can  produce  a 
value  to  be  read  or  receive  a  value  to  be  written.  Values  transferred  for  a  given  file  must  be  all  of  one 
type. 

Generally  in  Ada  documentation,  the  term  file  refers  to  an  object  of  a  certain  file  type,  whereas  a  physical 
mamfestation  is  known  as  an  external  file.  An  external  file  is  characterized  by; 

•"Its  NAME,  which  is  a  string  defining  a  legal  pathname  under  the  current  version  of  the  operating  system. 
For  example,  the  external  file  name  myfile  may  have  the  actual  rooted  path  /PROJECT/myf  ile.  In 
that  case,  use  of  myfile  as  a  string  specifying  an  external  file  would  be  legal  if  the  current  working 
directory  is  /PROJECT.  See  the  example  in  Section  F  8. 1. 2. 

•"Its  FORM,  which  gives  implementation -dependent  information  on  file  characteristics. 

Both  NAME  and  FORM  appear  explicitly  in  the  Ada  CREATE  and  OPEN  procedures.  Though  a  file  is  an 
object  of  a  certain  file  type,  ultimately  the  object  has  to  correspond  to  an  external  file.  Both  CREATE  and 
OPEN  associate  the  NAME  of  an  external  file  (of  a  certain  FORM)  with  a  program  file  object. 

Ada  I/O  operations  are  provided  by  standard  packages.  (See  the  LRM,  Chapter  14  for  more  details.) 
Table  F-4  describes  the  standard  Ada  I/O  packages. 


Table  F-4.  Standard  I/O  Packages 


Package 

Description  and  LRM  Location 

SEQUENTIAL_IO 

A  generic  package  for  sequential  files  of  a  single  element  type.  (Section 

14.  2.  3) 

OIRECT_IO 

A  generic  package  for  direct  (random)  access  files  of  a  single  element  type. 
(Section  1 4.  2.  5) 

TEXT_IO 

A  non-generic  package  for  ASCII  text  files.  (Section  14.  3.  10) 

I0_EXCEPTI0NS 

A  package  which  defines  the  exceptions  needed  by  the  above  three 
packages.  (Section  14.  5) 

The  generic  package  LOW  LEVEL  10  is  not  implemented. 
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F  8.1.1  Implementation-Dependent  Restrictions  on  I/O  Packages 

The  upper  bound  for  index  values  in  DIRECT _ lO  and  for  line,  column,  and  page  numbers  in  TEXT_IO 

is: 

. COUNT 'LAST  =  2**31  -1 

The  upper  bound  for  fields’  widths  in  TEXT_IO  is: 

. FIELD 'LAST  =  255 


F  8.1.2  Correspondence  between  External  Files  and  HP-UX  Files 

Ada  I/O  is  considered  in  terms  of  external  files.  Data  is  read  from  and  written  to  external  files.  Each 
external  file  is  implemented  as  a  standard  HP-UX  file.  However,  before  an  external  file  can  be  used  by 
an  Ada  program,  it  must  be  associated  with  a  file  object  belonging  to  that  program.  This  association  is 
achieved  by  supplying  the  name  of  the  file  object  and  the  name  of  the  external  file  to  the  procedures 
CREATE  or  OPEN  of  the  predefined  I/O  packages.  Once  the  association  has  been  made,  the  external  file 
can  be  read  from  or  written  to  with  the  file  object.  Note  that  for  SEQUENTIAL  10  and  DIRECT_I0  you 
must  first  instantiate  the  generic  package  to  produce  a  non-generic  instance.  Then  you  can  use  the 
CREATE  or  OPEN  procedure  of  that  instance.  The  example  at  the  end  of  this  section  illustrates  this 
instantiation  process. 

The  name  of  the  external  file  can  be  either  of  the  following: 

•"Null  string  (CREATE  only) 

•"HP-UX  pathname 

If  the  name  is  a  null  string,  the  associated  external  file  is  a  temporary  file,  created  using  the  HP-UX 
facility  tmpnani(3).  This  external  file  will  cease  to  exist  upon  completion  of  the  program. 

If  the  external  file  is  an  HP-UX  pathname,  the  pathname  is  extended  in  conformance  with  HP-UX  rules 
(see  intro  (2)  in  the  HP-UX  Reference).  The  exception  USE_ERR0R  is  raised  by  the  procedure  CREATE  if 
the  specified  external  file  is  a  device.  USE_ERROR  is  also  raised  for  cither  OPEN  or  CREATE  if  you  have 
insufficient  access  rights  to  the  file. 

When  using  OPEN  or  CREATE,  the  Ada  exception  NAME_ERROR  is  raised  if  any  path  component  exceeds 
255  characters  or  if  an  entire  path  exceeds  1023  characters.  This  limit  applies  to  path  components  and 
the  entire  path  during  or  after  the  resolution  of  symbolic  links  and  context-dependent  files  (CDFs). 


WARNING 


The  absence  of  NAME _ ERROR  does  not  guarantee  that  the  path  will  be 

used  as  given.  During  and  after  the  resolution  of  symbolic  links  and 
context-dependent  files  (CDFs),  the  underlying  file  system  may  truncate  an 
excessively  long  component  of  the  resulting  pathname.  For  example,  a 
fifteen  character  file  name  used  in  an  Ada  program  OPEN  or  CREATE  call 
will  be  silently  truncated  to  fourteen  characters  without  raising 

NAME _ ERROR  by  an  HP-UX  file  system  that  is  configured  for  "short 

filenames". 
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If  an  existing  external  file  is  specified  to  the  CREATE  procedure,  the  contents  of  that  file  will  be  deleted. 
The  recreated  file  is  left  open  as  for  a  newly  created  file,  for  later  access  by  the  program  that  made  the 
call  to  create  the  file. 


NOTE 


Executing  the  procedures  and  functions  of  the  predefined  I/O  packages 
involves  the  use  of  the  Ada  run-time  system  and  the  possible  execution  of 
a  number  of  HP-UX  I/O  primitives.  When  such  primitives  are  executed, 
an  HP-UX  I/O  signal  can  be  raised  (such  signals  are  raised,  for  example,  if 
errors  are  detected  during  the  processing  of  an  I/O  primitive). 

If  certain  HP-UX  I/O  signals  are  raised,  they  are  caught  and  processed  by 
the  Ada  run-time  system.  This  processing  causes  the  appropriate  Ada 
exception  to  be  raised.  Such  Ada  exceptions  can  then  be  handled  by  the 
Ada  program. 


EXAMPLE 


--  Example  of  creating  a  file  using  the  generic  package  DIRECT_IO 

—  The  example  also  illustrates  file  close  and  reopening  in  a  different 

--  access  mode 

with  DIRECT  10; 

with  TEXT_I0; 

procedure  RTEST  is 

package  INTIO  is  new  DIRECT_I0  (INTEGER);  --instantiate  on  INTEGER 
use  INTIO;  — types 

IFILE  :  INTIO. FILE  TYPE;  --  Define  a  file  object  for  reference  in  Ada 
IVALUE  :  INTEGER  :=  0;  --  Create  an  integer  element 

begin  --  RTEST 

CREATE  (  FILE  =>  IFILE,  --  Refer  to  file  object  IFILE 

MODE  =>  INTIO. INOUT  FILE,  --  Set  read/write  access  mode 
NAME  =>  "myfile"  --  Associate  an  external  file  name 

);  --  "myfile"  to  the  file  object,  IFILE 

TEXT_IO.PUT_LINE  ("Created  :"  i  INTIO. NAME  (IFILE)); 

CLOSE  (  F.’.E  =>  IFILE);  --  Close  the  external  file 

TEXT_IO.PUT_LINE( "Closed  file"); 

OPEN  (FILE  =>  IFILE,  —  Open  the  file  object 

MODE  =>  INTIO.OUT_FILE,  --  in  the  new  MODE  to  allow  write  only 

NAME  =>  "myfile"  --  Associate  an  external  file  name 

);  —  "myfile"  to  the  file  object,  IFILE 

TEXT_IO.PUT_LINE( "Opened  (new  mode)  :"  fc  INTIO. NAME  (IFILE)); 

INTIO. WRITE  (IFILE,  IVALUE)  ;  --  Write  an  integer  to  the  file 

TEXT  10. PUT  LINEC'Appended  an  Integer  to:"  &  INTIO. NAME  (IFILE)); 
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CLOSE  (  FILE  =>  IFILE); 

TEXT_IO.PUT_LINE ("Close  file"); 

end  RTEST; 

In  the  example  above,  the  file  object  is  IFILE,  the  external  file  name  relative  to  your  current  working 
directory  is  myfile,  and  the  actual  rooted  path  could  be  /PROJECT/myf  i  le.  Error  or  informational 
messages  from  the  Ada  development  system  (compiler,  tools)  may  mention  the  actual  rooted  path. 


NOTE 


The  Ada/300  development  system  manages  files  internally  so  that  names 
involving  symbolic  links  (see  ln(l))  are  mapped  back  to  the  actual  rooted 
path.  Consequently,  when  the  development  system  interacts  with  files 
involving  symbolic  links,  the  actual  rooted  pathname  may  be  mentioned  in 
informational  or  error  messages  rather  than  the  symbolic  name. 


F  8.1.3  Standard  Implementation  of  External  Files 

External  files  have  a  number  of  implementation-dependent  characteristics,  such  as  their  physical 
organization  and  file  access  rights.  It  is  possible  to  customize  these  characteristics  through  the  FORM 
parameter  of  the  CREATE  and  OPEN  procedures,  described  fully  in  Section  F  8.2.  The  default  of  FORM  is 
the  null  string.  The  following  section  describes  the  standard  or  default  implementation  of  three  types  of 
external  files;  sequential,  direct,  and  text.  Default  protection  for  external  files  is  also  described. 


NOTE 


In  the  absence  of  the  FORM  parameter,  default  protection  is  a  function  of 
the  HP-UX  operating  system  (see  Section  F  8. 2  which  follows). 


F  8. 1.3.1  Sequential  Files 

A  sequential  file  is  a  sequence  of  values  that  are  transferred  in  the  order  of  their  appearance  (as  produced 
by  the  program  or  by  the  run-time  environment).  A  file  is  a  collection  of  data  elements  (object 
components)  of  identical  type.  Each  object  in  a  sequential  file  has  exactly  the  same  binary  representation 
as  the  Ada  object  in  the  executable  program. 

The  information  placed  in  a  sequential  file  depends  on  whether  the  type  used  for  the  instantiation  of  the 
sequential  I/O  package  is  constrained  or  unconstrained.  If  it  is  constrained,  the  objects  are  put 
consecutively  into  the  file,  without  holes  or  separators.  If  the  type  is  unconstrained,  the  length  of  the 
object  (in  bytes)  is  added  to  the  front  of  the  object  as  a  32-bit  integer  value.  See  Section  F  8. 2.  5  for  a 
detailed  description.  The  default  is  that  there  is  no  buffer  between  the  physical  external  file  and  the  Ada 
program.  However,  see  Section  F  8. 2. 6  for  details  on  specifying  a  file  BUFFER  SIZE 
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F  8.13.2  Direct  Files 

A  direct  access  file  is  a  set  of  elements  occupying  consecutive  positions  in  a  linear  order.  The  position  of 
an  element  in  a  direct  file  is  specified  by  its  index,  which  is  an  integer  in  the  range  I  to  (2**31)-1  of 
subtype  POSITIVE_COUNT.  If  the  file  is  created  with  the  default  FORM  parameter  attributes  (see  Section 
F  8.2),  only  objects  of  a  constrained  type  can  be  written  to  or  read  from  a  direct  access  file.  Such  objects 
have  exactly  the  same  binary  representation  as  the  Ada  object  in  the  executable  program.  Although 
instantiation  of  DIRECT_IO  is  accepted  for  unconstrained  types,  the  exception  LISE_ERROR  is  raised  on  any 
call  to  CREATE  or  OPEN  where  the  object  is  of  an  unconstrained  type.  Using  the  FORM  parameter  allows 
you  to  store  unconstrained  objects  in  a  direct  access  file  by  specifying  the  maximum  RECORD_SIZE  of 
unconstrained  types. 

A  file  is  a  collection  of  data  elements  (object  components)  of  identical  type.  All  elements  within  the  file 
have  the  same  length.  The  number  of  bytes  occupied  by  each  element  is  determined  by  the  size  of  the 
object  stored  in  the  file.  The  default  is  that  there  is  no  buffer  between  the  physical  external  file  and  the 
Ada  program.  See  Section  F  8. 2. 6  for  details  on  specifying  a  file  BUFFER  SIZL 


F  8.1.3. 3  Text  Files 

Text  files  are  used  for  the  input  and  output  of  information  which  is  in  a  readable  form.  Each  text  file  is 
read  or  written  sequentially,  as  a  sequence  of  characters  grouped  into  lines,  and  as  a  sequence  of  lines 
grouped  into  pages.  All  text  file  column  numbers,  line  numbers,  and  page  numbers  are  in  the  range  1  to 
(2**3I)-1  of  subtype  POSITIVE_COUNT.  The  line  terminator  (end-of-line)  is  physically  represented  by 
the  ASCII  character  ASCII.LF.  The  page  terminator  (end -of -page)  is  physically  represented  by  a 
succession  of  the  two  characters,  ASCII.LF  and  ASCII.FF,  in  that  order.  The  file  terminator 
(end-of-file)  is  physically  represented  by  the  character  ASCII.LF,  followed  by  the  HP-UX 
END-OF-FILE.  See  Section  F  8. 2. 5  in  this  appendix  for  more  information  about  structuring  text  files. 

If  you  control  line,  page,  and  file  structure  by  calling  predefined  subprograms  (LRM,  Section  1 4.  3. 4),  you 
need  not  be  concerned  with  the  above  terminator  implementation  details.  If  you  effect  structural  control 
by  explicitly  inputting  or  outputting  these  control  characters  (via  the  PUT  function,  for  example),  it  is 
your  responsibility  to  maintain  the  integrity  of  the  external  file.  The  standard  implementation  of  text 
files  does  not  buffer  text  file  I/O.  However,  buffering  is  a  device -dependent  characteristic  that  can  be 
modified  at  the  system  level  (for  example,  to  buffer  lines  of  text  entered  from  a  terminal). 


CAUTION 


If  a  terminal  is  used  for  text  input,  the  functions  END  OF  PAGE  and 
END  OF  FILE  always  return  FALSE. 


F  8.1.4  Default  Access  Protection  of  External  Files 

HP-UX  provides  protection  of  a  file  by  means  of  access  rights.  These  access  rights  are  used  within  Ada 
programs  to  protect  external  files.  There  are  three  levels  of  protection: 

•"User  (the  owner  of  the  file). 

•"Group  (users  belonging  to  the  owner’s  group). 

•"Others  (users  belonging  to  other  groups). 

For  each  of  these  levels,  access  to  the  file  can  be  limited  to  one  or  several  of  the  following  rights:  read. 
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write,  or  execute.  The  standard  external  file  access  rights  are  specified  by  the  UMASK  command  (see 
ufflask(  1 )  and  umask(2)  in  the  HP-UX  Reference).  Access  rights  apply  equally  to  sequential,  direct,  and 
text  files.  See  the  section  on  the  FORM  parameter  (F  8.  2)  for  information  about  specifying  file  permissions 
at  the  time  of  CREATL 


F  8.1.5  The  Sharing  of  External  Files  and  Tasking  Issues 

Several  file  objects  can  be  associated  with  the  same  external  file.  The  objects  can  have  identical  or 
differing  I/O  modes;  each  file  object  has  independent  access  to  the  external  file.  The  effects  of  sharing  an 
external  file  depend  on  the  nature  of  the  file.  You  must  keep  in  mind  the  nature  of  the  device  attached 
to  the  file  object  and  the  sequence  of  I/O  operations  on  the  device.  Multiple  I/O  operations  on  an 
external  file  shared  by  several  file  objects  are  processed  in  the  order  they  occur. 

In  the  case  of  shared  files  on  random  access  devices,  such  as  discs,  the  data  is  shared.  Reading  from  one 
file  object  does  not  affect  the  file  positioning  of  another  file  object,  nor  the  data  available  to  it.  However, 
simultaneous  reading  and  writing  of  separate  file  objects  to  the  same  random  access  external  file  (a  direct 
access  file,  for  example)  should  be  avoided;  due  to  buffering,  the  effects  are  unpredictable.  File  buffering 
may  be  enabled  by  using  the  FORM  parameter  attributes  at  the  time  you  open  or  create  the  file. 

In  the  case  of  shared  files  as  sequential  or  interactive  devices,  such  as  magnetic  tapes  or  keyboards,  the 
data  is  no  longer  shared.  In  other  words,  a  magnetic  record  or  keyboard  input  buffer  read  by  one  I/O 
operation  is  no  longer  available  to  the  next  operation,  whether  it  is  performed  on  the  same  file  object  or 
not.  This  is  simply  due  to  the  sequential  nature  of  the  device.  By  default,  file  objects  represented  by 
STANDARD_IN  and  STANDARD__OUT  are  preconnected  to  the  HP-UX  streams  stdin  and  stdout  (see 
8tdio(5)),  and  thus  are  of  this  sequential  variety  of  file.  The  HP-UX  stream  stderr  is  not  preconnected 
to  an  Ada  file  but  is  used  by  the  Ada  run-time  system  for  error  messages. 

Each  file  operation  is  completed  before  a  subsequent  file  operation  commences.  In  a  tasking  program,  this 
means  no  explicit  synchronization  needs  to  be  performed  unless  the  order  of  I/O  operations  is  critical.  An 
Ada  tasking  program  is  erroneous  if  it  depends  on  the  order  of  I/O  operations  without  explicitly 
synchronizing  them.  Remember  that  the  files  associated  with  STANDARD_IN  and  STANDARD_Ol/T  are 
shared  by  all  tasks,  and  that  care  must  be  taken  when  Ada  file  objects  use  buffered  I/O. 


NOTE 


The  sharing  of  external  files  discussed  here  is  system-wide  and  is  managed 
by  the  HP-UX  operating  system.  Several  programs  may  share  one  or  more 
external  files.  The  file  sharing  using  the  FORM  parameter  SHARED,  which  is 
discusaed  in  F  8. 2. 4,  is  not  system-wide,  but  is  a  file  sharing  within  an  Ada 
program  and  is  managed  by  that  program.  Synchronized  access  to  a  file 
shared  using  the  FORM  parameter  SHARED  is  your  responsibility. 


F  8.1.6  I/O  Involving  Access  Types 

When  an  object  of  an  access  type  is  specified  as  the  source  or  destination  of  an  I/O  operation  (read  or 
write),  the  32-bit  binary  access  value  is  read  or  written  unchanged.  If  an  access  value  is  read  from  a  file, 
take  care  to  ensure  that  the  access  value  so  read  designates  a  valid  object.  This  is  only  likely  to  be  the 
case  if  the  access  value  read  was  previously  written  by  the  same  program  that  is  reading  it,  and  the  object 
which  it  designated  at  the  time  it  was  written  still  exists  (that  is,  the  scope  in  which  it  was  allocated  has 
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not  been  exited,  nor  has  an  UNCHECKED_DEALLOCATION  been  performed  on  it).  A  program  may  execute 
erroneously  if  an  access  type  read  from  a  file  docs  not  designate  a  valid  object. 

F  8.1.7  I/O  Involving  Local  Area  Networks 


This  section  assumes  knowledge  of  both  remote  file  access  and  networks.  It  describes  Ada  program  I/O 
involving  two  Local  Area  Network  (LAN)  services  available  on  the  Series  300  computers; 

1.  RFA  systems:  remote  file  access  (RFA)  using  the  NS/9000  network  services  software. 

* 

2.  NFS  systems:  remote  file  access  using  the  NFS  network  services  software. 


The  Ada  programs  discussed  here  are  executed  on  a  local  (host)  computer.  These  programs  access  or  create 
files  on  a  remote  system,  which  is  located  on  a  mass  storage  device  not  directly  connected  to  the  host 
computer.  The  remote  file  system  can  be  mounted  and  accessed  by  the  host  computer  using  RFA  or  NFS 
LAN  services.  RFA  systems  are  described  in  Network  Services/9000  LAN  User's  Guide  for  HP  9000 
Computers.  NFS  systems  are  described  in  Using  and  Administering  NFS  Services. 

Note  that  Ada  I/O  can  be  used  reliably  across  local  area  networks  using  RFA  only  if  the  network  special 
files  representing  remote  file  systems  are  contained  in  the  directory  /net,  as  is  customary  on  HP-UX 
systems.  See  the  HP-UX  System  Administrator  Manual  (for  the  Series  300)  for  more  details. 


F  8.1.7.1  RFA  Systems 

Properly  specified  external  files  can  be  created  or  accessed  reliably  from  Ada  programs  across  the  LAN  on 
RFA  systems.  You  can  create  or  access  a  file  only  if  an  RFA  connection  exists  from  the  remote  file 
system  at  the  time  your  Ada  program  is  executed.  The  example  on  the  following  page  illustrates  remote 
file  access  and  use. 

In  this  example,  a  remote  network  connection  to  a  system  cezanne  is  assumed.  This  connection  could 
have  been  made  by  typing,  for  example,  (where  is  the  shell  prompt), 

netunam  /net/cezanne  userjtame: 

Password:  user _pass>i)d 


NFS  is  a  trademark  of  Sun  Microsystems,  Inc. 
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EXAMPLE 


with  DIRECT_IO; 
procedure  LANTEST  is 

--  instantiate  the  generic  package  DIRECT_IO 
--  for  files  whose  component  type  is  INTEGER, 
package  TESTIO  is  new  DIRECT  IO( INTEGER); 
use  TESTIO; 

REMOTE_FILE  :  TESTIO. FI LE_TYPE; 

I VALUE  :  INTEGER  :=  0  ; 

RVALUE  :  INTEGER  :=  -1  ; 

begin 


--  create  a  remote  file 

TESTIO. CREATE  (FILE  *>  REMOTE_FILE, 

MODE  =>  TESTIO. OUT_F I LE,  --OUT  mode  for  DIRECT_IO 
NAME  =>  "/net/cezanne/project/test . file" ) ; 

—  Close  the  file 

TESTIO. CLOSE  (FILE  =>  REMOTE_FILE)  ; 

--  Re-open  the  file  with  different  file  mode 
TESTIO. OPEN  (FILE  =>  REMOTE_FILE, 

MODE  =>  TESTIO.INOUT_FILE,  --INOUT  mode  for  DIRECT_IO 
NAME  =>  ”/net/cezanne/project/test.file") ; 

--  Write  an  integer  (0)  to  the  file 
TESTIO. WRITE  (REMOTE_FILE,  IVALUE); 

--  Reset  the  file  pointer  in  the  file 
TESTIO. RESET  (REMOTE_FILE) ; 

--  Read  from  the  file,  rvalue  should  now  be  zero 
TESTIO. READ  (REMOTE_FILE,  RVALUE); 

—  Close  the  file 

CLOSE  (FILE  =>  REMOTE_FILE); 

end  LANTEST; 


F  8. 1.7.2  NFS  Systems 

If  an  Ada  program  expects  to  access  or  create  a  file  on  a  remote  file  system  using  NFS  LAN  services,  the 
remote  volumes  which  contain  the  file  system  must  be  mounted  on  the  host  computer  prior  to  the 
execution  of  the  Ada  program. 

For  example,  assume  that  the  remote  system  (cezanne)  exports  a  file  system  /project,  /project  is 
mounted  on  the  host  computer  as  /ada/project.  Files  in  this  remote  file  system  are  accessed  or  created 
by  references  to  the  files  as  if  they  were  part  of  the  local  file  system.  To  access  the  file  test. file,  the 
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program  would  reference  /ada/project/test.  file  on  the  local  system.  Note  that  test,  file  appears 
IS  /project/test. file  on  the  remote  system.  The  netuman(  1 )  command  (from  HP’s  NS/9000)  is  not 
used  in  NFS. 

The  remote  file  system  must  be  exported  to  the  local  system  before  it  can  be  locally  mounted,  using  the 
mount ( 1m)  command. 


F  8.1.8  Implementation-Defined  I/O  Packages 

UNIX_ENV  is  the  only  implementation-defined  I/O  package.  An  Ada  program  that  does  not  use  UNIX  ENV 
has  no  implicit  access  to  its  execution  environment  without  using  the  package  UNIX  ENV.  In  particular, 
there  is  no  direct  equivalent  to  the  arge  and  argv  parameters  of  a  C  Language  mam  program.  In  this 
implementation,  parameters  cannot  be  passed  to  a  procedure  used  as  an  Ada  main  program  unless  the 
HP-supplied  package  UNIX_ENV  is  used..  The  binder  will  not  bind  a  program  with  parameters  in  its  main 
program.  The  implementation -defined  package  UNIX_ENV  enables  an  Ada  program  to  retrieve 
information  from  the  HP-UX  environment.  The  specification  of  UNIX_ENV  is  listed  in  the  Ada  User's 
Guide. 


F  8.1.9  Potential  Problems  With  I/O  From  Ada  Tasks 

In  an  Ada  tasking  environment  on  the  HP  9000  Series  300,  the  Ada  run  time  provides  some  protection  of 
file  objects  against  attempts  to  perform  multiple  simultaneous  I/O  operations  on  the  same  logical 
(internal)  file.  (Note  that  this  is  not  the  same  as  the  sharing  of  an  external  file  through  multiple  internal 
files  which  is  supported  in  a  controlled  fashion  by  the  use  of  the  FORM  parameter  in  CREATE  or  OPEN 
calls.)  When  multiple  tasks  attempt  to  share  an  internal  file  without  proper  synchronization,  intermixing 
of  two  I/O  operations  on  the  same  internal  file  (an  Ada  file  object)  can  occur  due  to  task  scheduling.  If 
such  a  situation  exists  and  two  I/O  operations  collide,  PROGRAM_ERROR  will  be  raised  by  the  Ada  I/O 
package. 


CAUTION 


It  is  your  responsibility  to  utilize  proper  synchronization  and  mutual 
exclusion  in  the  use  of  shared  resources.  Note  that  shared  access  to  a 
common  resource  (in  this  case,  a  file)  could  be  achieved  by  rendezvous 
between  tasks  that  share  that  resource.  If  you  write  a  program  in  which 
two  tasks  attempt  to  perform  I/O  operations  on  the  same  logical  file 
without  proper  synchronization,  that  program  is  erroneous.  (See  LRM, 
Section  9.  11.) 


F  8.1.10  I/O  Involving  Symbolic  Links 

Some  caution  must  be  exercised  when  using  an  Ada  program  that  performs  I/O  operations  to  files  that 
involve  symbolic  links.  (For  more  detail  on  the  use  of  symbolic  links  to  files  in  HP-UX,  see  ln(  1 ).) 

Creating  a  symbolic  link  to  a  file  creates  a  new  name  for  that  file  that  is,  in  effect,  an  alias  for  the  actual 
file  name.  If  you  use  the  actual  file  name  or  its  alias  (that  is,  the  name  involving  symbolic  links),  Ada  I/O 
operations  will  work  correctly.  However,  the  NAME  function  (in  the  TEXT  10,  SEQUENTIAL_IO,  and 
DIRECT_IO  packages)  will  always  return  the  actual  rooted  path  of  a  file  and  not  a  path  involving 
symbolic  links. 
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F  8.1.11  Ada  I/O  System  Dependencies 

Ada/300  has  a  requirement  (see  LRM.  Section  14.  2.  1  21)  that  the  NAME  function  must  return  a  string 
that  uniquely  identifies  the  externa]  file  in  HP-UX.  In  determining  the  unique  file  name,  the  Ada/300 
lO  system  may  need  to  access  directories  and  directory  entries  not  directly  associated  with  the  specified 
file.  This  IS  particularly  true  when  the  path  to  the  file  specified  involves  either  NFS  or  NS/9000  RF.A 
remote  file  systems.  This  access  involves  HP-UX  operating  system  calls  that  are  constrained  by  HP-UX 
access  permissions  and  are  subject  to  failures  of  the  underlying  file  system,  as  well  as  by  network  behavior. 


WARNING 


It  is  during  the  Ada/300  OPEN  and  CREATE  routines  that  the  unique  file 
name  is  determined  for  later  use  by  the  NAME  function.  The  Ada  NAME 
function  only  reports  a  unique  file  name  for  an  associated  file  object  after 

a  successful  call  to  OPEN  and  CREATL  If  unsuccessful,  the  USE _ ERROR 

exception  is  raised. 

If  the  underlying  file  system  or  network  denies  access  (possibly  due  to  a 
failed  remote  file  system)  or  the  access  permissions  are  improper,  either 
OPEN  or  CREATE  will  raise  an  Ada  exception  or  the  call  may  not  complete 
until  the  situation  is  corrected. 


For  example,  when  opening  a  file,  the  Ada  exception  NAME_ERROR  is  raised  if  there  are  any  directories 
in  the  rooted  path  of  the  file  that  are  not  readable  or  marchable  by  the  "effective  uid"  of  the  program. 
This  restriction  applies  to  intermediate  path  components  that  are  encountered  during  the  resolution  of 
symbolic  links. 

Also,  if  an  NFS  "hard"  mount  of  a  remote  file  system  fails,  an  OPEN  or  CREATE  call  on  a  file  whose  actual 
rooted  path  contains  the  parent  directory  of  the  NFS  mount  point  may  not  complete  until  the  NFS  failure 
is  corrected. 
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F  8.2  The  FORM  Parameter 

For  both  the  CREATE  and  OPEN  procedures  in  Ada,  the  FORM  parameter  specifies  the  characteristics  of  the 
external  file  involved. 

The  CREATE  procedure  establishes  a  new  external  file  of  a  given  NAME  and  FORM,  and  associates  with  it  a 
specific  program  FILE  object.  The  external  file  is  created  (and  the  FILE  object  set)  with  a  certain  file 
MODE.  If  the  file  already  exists  with  the  same  NAME  as  stated  in  the  CREATE  call,  the  file  will  be  erased 
and  then  recreated.  The  exception  USE_ERROR  is  raised  if  the  file  mode  is  IN_FILE. 

If  you  execute  an  Ada  program  containing  a  CREATE  statement,  you  must  have  adequate  permission  for 
file  creation  in  HP-UX.  Otherwise,  the  CREATE  procedure  will  raise  STATUS_ERROR  or  USE_ERROR  on 
attempts  to  recreate  (erase)  an  existing  file  (regardless  of  the  FORM  parameter  setting  permissions).  For 
example,  an  existing  file  with  no  read,  write,  or  execute  permission  for  the  user  who  executes  such  an  Ada 
program  (one  which  attempts  to  create  a  file  by  the  same  name),  will  raise  STATUS_ERROR  or  USE_ERROR. 

The  OPEN  procedure  associates  an  existing  external  file  of  a  given  NAME  and  FORM,  with  a  specified 
program  FILE  object.  The  procedure  also  sets  the  current  FILE  mode.  If  there  is  an  inadmissible  change 
of  MODE,  an  Ada  USE  ERROR  is  generated. 


F  8.2.1  An  Overview  of  FORM  Attributes 

The  FORM  parameter  is  composed  from  a  list  of  attributes  that  specify 

•"File  protection 

•"File  sharing 

•"File  structuring 

•"Buffering 

•"Appending 

•"Blocking 

•"Terminal  Input 


F  8.2.2  The  Format  of  FORM  Parameters 

Attributes  of  the  FORM  parameter  have  a  keyword  followed  by  the  Ada  "arrow  symbol"  (■>)  (see  LRM, 
Section  2.  2(10)),  followed  by  qualifier.  The  qualifier  and  arrow  symbol  may  sometimes  be  omitted.  Thus, 
the  format  for  an  attribute  specifier  is 

KEYWORD 

or 

KEYWORD  =)  QUALIFIER 
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The  general  format  for  the  FORM  parameter  is  a  string  formed  from  a  list  of  attributes,  with  attributes 
separated  by  commas  (,).  The  string  is  not  case  sensitive.  The  arrow  symbol  can  be  separated  by  spaces 
from  the  keyword  and  qualifier.  The  two  forms  below  are  equivalent; 

KEYWORD  =>  QUALIFIER 

KEYWORD ->OUALIFIER 

In  some  cases,  an  attribute  can  have  multiple  qualifiers  that  can  be  presented  at  the  same  time.  In  cases 

that  allow  multiple  qualifiers,  additional  qualifiers  are  introduced  with  an  underscore  ( _ ).  Note  that 

spaces  arc  not  allowed  between  the  additional  qualifiers;  only  underscore  characters  are  allowed. 
Otherwise,  a  USE_ERROR  exception  is  raised  by  CREATE.  The  two  examples  that  follow  illustrate  the 
FORM  parameter  format. 

The  first  example  illustrates  the  use  of  the  FORM  parameter  in  the  TEXT^IO.OPEN  to  set  the  file  buffer 
size. 

—  Example  of  opening  a  file  using  the  non-generic  package  TEXT  10 
—  This  illustrates  the  use  of  the  FORM  parameter  BUFFER  SIZE 
--  Note:  "inpt  file"  must  exist,  or  NAME_ERROR  will  be  raised. 

with  TEXT_IO; 
procedure  STEST  is 

TFILE  :  TEXT  10, FILE  TYPE;  --Define  a  file  object  for  reference  in  Ada 
begin  --  STEST 

TEXT_IO.OPEN  (FILE  =>  TFILE,  --  Refer  to  file  object  created  above 
MODE  =>  TEXT^IO. 1N_FI LE ,  --Set  mode  for  READ  access  only 
NAME  =>  "inpt  file",  --  Associate  an  external  file  name 
—  "inpt_file"  to  the  file  object:  TFILE 
FORM  =>  "BUFFER  SIZE  =>4096"--set  buffer  size  to  4K  bytes 
); 

end  STEST; 

The  second  example  illustrates  the  use  of  the  FORM  parameter  in  TEXT_IO .  CREATL  This  example  sets  the 
access  rights  of  the  owner  (HP-UX  file  permissions)  on  the  created  file  and  shows  multiple  qualifiers  being 
presented  at  the  same  time. 

TEXT_IO. CREATE  (OUTPUT_FI LE ,  TEXT_IO. OUT_FI LE ,  OUTPUT_FI LE_NAME, 

FORM=> "owns r=> read  write  execute"); 


B-54 


Implementation -Dependent  Characteristics 


F  8.2.3  The  FORM  Parameter  Attribute  -  File  Protection 

The  file  protection  attribute  is  only  meaningful  for  a  call  to  the  CREATE  procedure. 

File  protection  involves  two  independent  classifications.  The  first  classification  specifies  which  user  can 
access  the  file  and  is  indicated  by  the  keywords  listed  in  Table  F-5. 


Table  F-5.  User  Access  Categories 


Category 

Grants  Access  To 

OWNER 

Only  the  owner  of  the  created  file. 

GROUP 

Only  the  members  of  a  defined  group. 

WORLD 

Any  other  users. 

Note  that  WORLD  is  similar  to  “others"  in  HP-UX  terminology,  but  was  used  in  its  place  because  OTHCRS  is 
an  Ada  reserved  word. 

The  second  classification  specifies  access  rights  for  each  classification  of  user.  The  four  general  types  of 
access  rights,  which  are  specified  in  the  FORM  parameter  qualifier  string,  are  listed  in  Table  F-6. 


Table  F-6.  File  Access  Rights 


Category 

Allows  the  User  To 

READ 

Read  from  the  external  file. 

WRITE 

Write  to  the  external  file. 

EXECUTE 

Execute  a  program  stored  in  the  external  file. 

NONE 

The  user  has  no  access  nghts  to  the  external  file.  (This 

qualifier  overrides  any  prior  privileges.) 

More  than  one  access  nght  can  be  specified  for  a  particular  file.  Additional  access  rights  can  be  indicated 
by  separating  them  with  an  underscore  as  noted  earlier.  The  following  example  using  the  FORM  parameter 
m  TEXT_IO. CREATE  sets  access  nghls  of  the  owner  and  other  users  (HP-UX  file  permissions)  on  the 
created  file.  This  example  illustrates  multiple  qualifiers  being  used  to  set  several  permissions  at  the  same 
time. 


TEXT_IO. CREATE  (OUTPUT_FI LE ,  TEXT_IO . OUT_FI LE ,  OUTPUT_FILE_NAME, 
FORM=>’'owner=>  read  write  execute,  wor ld=  >none"  ) ; 
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Note  that  the  HP-UX  umask(l)  and  umask(2)  commands  may  have  set  the  default  rights  for  any 
unspecified  permissions.  In  the  previous  example,  permission  for  the  users  in  the  category  GROUP  were 
unspecified.  Typically,  the  default  umask  will  be  set  so  that  the  default  allows  newly  created  files  to  have 
read  and  write  permission  -  and  no  execute  permission  -  for  each  category  of  user  (USER,  GROUP,  and 
WORLD). 

Consider  the  case  where  the  users  in  WORLD  want  to  execute  a  program  in  an  external  file,  but  only  the 
owner  may  modify  the  file. 

The  appropriate  FORM  parameter  is  then: 

WORLD  =>  EXECLTTE, 

OWNER  *>  READ_WRITE_EXECUTE 

This  would  be  applied  as; 

TEXT_IO. CREATE  (OUTPUT^FILE,  TEXT_IO. OUT_FILE ,  OUTPUT_FILE_NAME , 

'FORM=>’’^world=>«xecute ,  owner=>  read  wri  te_execute" ) ; 

Repetition  of  the  same  qualifier  within  attributes  is  illegal; 

WORLD  =>  EXECaTE_EXECUTE  --  NOT  legal 

But  repetition  of  entire  attributes  is  allowed; 

WORLD  =>  EXECUTE,  WORLD  =>  EXECUTE  --  legal 


F  8.2.4  The  FORM  Parameter  Attribute  -  File  Sharing 

The  file  sharing  attribute  of  the  FORM  parameter  provides  control  over  multiple  access  to  a  given  external 
file  from  within  an  Ada  program.  For  example,  the  controlled  file  sharing  could  be  among  separate  Ada 
tasks.  The  control  over  multiple  access  does  not  extend  to  the  whole  system.  See  Section  F  8.  1.5  for 
details  on  file  sharing  at  the  system  level  between  separate  programs  for  more  details.  The  HP-UX 
operating  system  controls  file  sharing  at  the  system  level;  the  programmer  controls  the  file  sharing 
described  here.  File  sharing  with  the  FORM  parameter  occurs  within  a  single  Ada  program. 

An  external  file  can  be  shared;  that  is,  the  external  file  can  be  associated  simultaneously  with  several 
logical  file  objects  created  by  the  OPEN  or  CREATE  procedures.  The  file  sharing  attribute  restricts  or 
suppresses  this  capability  by  specifying  one  of  the  modes  listed  in  Table  F-7. 
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Table  F-7.  File  Sharing  Attribute  Modes 


Mode 

Description 

NOT_SHARED 

Indicates  exclusive  access.  No  other  logical  file  can  be 
associated  with  the  external  file. 

SHARED=>READERS 

Only  logical  files  of  mode  IN  can  be  associated  with  the 
external  file. 

SHARED=>SINGLE_WRITER 

Only  logical  files  of  mode  IN  and  at  most  one  file  with 
mode  OUT  can  be  associated  with  the  external  file. 

SHARED=>ANY 

No  restrictions;  this  is  the  default. 

A  USE_ERROR  exception  is  raised  if  either  of  the  following  conditions  exists  for  an  external  file  already 
associated  with  a  logical  Ada  file: 

•"A  further  OPEN  or  CREATE  specifies  a  file  sharing  attribute  different  from  the  current  one. 

•"A  further  OPEN,  CREATE,  or  RESET  violates  the  conditions  imposed  by  the  current  file  sharing 
attribute. 

The  restrictions  imposed  by  the  file  sharing  attribute  disappear  when  the  last  logical  file  linked  to  the 
external  file  is  closed.  The  default  ANY  allows  multiple  writers  to  a  file.  Specifying  ANY  can  produce  an 
unexpected  sequence  of  output  operations.  Tasking  programs  should  use  synchronization  via  rendezvous  to 
prevent  problems  that  may  arise  in  accessing  a  shared  file.  (See  Section  F  8.  1.9.) 
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F  8.2.5  The  FORM  Parameter  Attribute  -  File  Structuring 

This  section  describes  how  to  structure  your  files. 


F  8. 2.5.1  Text  Files 

There  is  no  FORM  parameter  to  define  the  structure  of  text  files.  A  text  file  consists  of  a  sequence  of  bytes 
containing  ASCII  character  codes. 

You  can  control  Ada  terminators  explicitly  in  text  files.  The  representation  of  Ada  terminators  depends 
on  the  file’s  mode  (IN  or  OUT)  and  whether  it  is  associated  with  a  terminal  device  or  a  mass-storage  file. 
See  Table  F-8  which  follows. 

Table  F-8.  Text  File  Terminators 


File  Type 

Terminator 

Mass -storage  files 

end  of  line:  ASCII. LF 

end  of  page:  ASCII.LF  ASCII.FF 

end  of  file:  ASCII.LF  ASCI I. EOT 

Terminal  device/  IN  mode 

end  of  line:  ASCII.LF 

end  of  page:  ASCII.LF  ASCII.FF 

end  of  file:  ASCII.LF  ASCII.FF 

Terminal  device/  OUT  mode 

end  of  line:  ASCII.LF 
end  of  page:  ASCII.FF 
end  of  file:  ASCI I. EOT 

See  Section  F  8.  1.  3.  3  for  more  information  about  terminators  in  text  files. 


F  8. 2.5.2  Binary  Files 

This  section  describes  use  of  the  FORM  parameter  for  binary  (sequential  or  direct  access)  files.  Two  FORM 
attributes,  RECORD_SIZE  and  RECORD_UNIT,  control  the  structure  of  binary  files. 

Such  a  file  can  be  viewed  as  a  sequence  or  a  set  of  consecutive  RECORDS.  The  structure  of  a  record  is 

(  HEADER  ]  OBJECT  (  UNUSED_PART  ] 

A  record  is  composed  of  up  to  three  items: 

1.  A  HEADER  consisting  of  two  fields  (each  of  32  bits) 

•"The  length  of  the  object  in  bytes. 

•"The  length  of  the  descriptor  in  bytes. 

2.  An  OBJECT  with  the  exact  binary  representation  of  the  Ada  object  in  the  executable  program,  possibly 
including  an  object  descriptor. 
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3.  An  UNUSED_PART  of  variable  size  to  permit  full  control  of  the  record’s  size. 

The  HEADER  is  implemented  only  if  the  actual  parameter  of  the  instantiation  of  the  I/O  package  is 
unconstrained. 

The  file  structure  attributes  take  the  form: 

RECORD_SI2E  =>  s i2e_in_bytes 
RECORD_UNIT  =>  s i2e_in_bytea 

The  attributes’  meaning  depends  on  the  object’s  type  (constrained  or  unconstrained)  and  the  file  access 
mode  (sequential  or  direct  access). 

The  two  types  of  access  are: 

•"Sequential  access  of  consecutive  RECORDS 

•"Direct  access  of  consecutive  RECORDS 

The  consequences  of  this  are  shown  in  Table  F-9  on  the  following  page. 
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Tabic  F-9.  Structuring  Binary  Files  With  the  FORM  Parameter 


Object  Type 

i 

File  Access 

Mode 

RECORD_L'MT 

Attribute 

RECORD_SIZE 

Attribute 

Constrained 

1 

Sequential  I/O 

The  RECORD  UNIT  attribute 
is  illegal. 

If  the  REC0RD_S1ZE 
attribute  is  omitted,  no 
UNUSED_PART  is 
implemented.  The  default 
RECORD^SIZE  is  the  object’s 
size. 

If  present,  the  RECORD_SIZE 
attribute  must  specify  a 
record  size  greater  than  or 
equal  to  the  object’s  size. 
Otherwise,  the  exception 
USE_ERROR  is  raised. 

Unconstrained 

Sequential  I/O 

By  default,  the 

RECORD_UNIT  attribute 
is  one  byte. 

The  RECORD_SI2E  attribute 
is  illegal. 

The  size  of  the  record  is  the 
smallest  multiple  of  the 
specified  (or  default) 
RECORD_UNIT  that  holds 
the  object  and  its  length. 

This  is  the  only  case  where 
record  of  a  file  can  have 
different  sizes. 

Direct  I/O 

The  RECORD_UNIT  attribute 
is  illegal. 

The  RECORD_SI2E  attribute 
has  no  default  value,  and  if 
a  value  is  not  specified,  a 
USE_ERROR  is  raised. 

1 

1 

If  you  attempt  to  input  or 
output  an  object  larger  than 
the  given  RECORD  SIZE,  a 
DATA  ERROR  exception  is 
raised. 

If  you  CREATE  a  direct  access  file  with  the  default  FORM  parameter,  then  only  objects  of  a  constrained 
type  can  be  written  to  or  read  from  that  direct  access  file. 
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F  8.2.6  The  FORM  Parameter  Attribute  -  File  Buffering 

The  buffer  size  can  be  specified  by  the  attribute. 

BUFFER  SIZE  =>  s i2e_in_by tes 

The  default  value  for  BUFFER_SIZE  is  0  for  terminal  devices  (which  means  no  buffering),  and  1 _ sector 

for  disc  files.  Using  the  file  buffering  attribute  can  improve  I/O  performance  in  some  cases. 

An  example  of  the  use  of  the  FORM  parameter  in  the  TEXT_IO.OPEN  to  set  the  file  buffer  size  is  shown 
below; 

--  Example  of  creating  a  file  using  the  non-generic  package  TEXT_IO 
--  This  illustrates  the  use  of  the  FORM  parameter  BUFFER_SIZE 

with  TEXT_IO; 
procedure  T_TEST  is 

BFILE  :  TEXT_IO. FILE_TYPE;  --  Define  a  file  object  for  reference  in  Ada 
begin  --  T_TEST 

TEXT  10. CREATE  (FILE  =>  BFILE,  --  Refer  to  file  object  created  above 

MODE  =>  TEXT_IO.OUT_FILE,  --  Set  WRITE  access  only  mode 
NAME  =>  "txt_file",  --  Associate  an  external  file  name 
--  "txt  file"  to  the  file  object:  BFILE 
FORM  s>  "BUFFER  SIZE=>8192" --set  buffer  size  to  8K  bytes 
); 

end  T  TEST; 


F  8.2.7  The  FORM  Parameter  -  Appending  to  a  File 

The  APPEND  attribute  can  only  be  used  with  the  procedure  OPEN.  Its  format  is; 

APPEND 

Any  output  will  be  placed  at  the  end  of  the  named  external  file. 

In  normal  circumstances,  when  an  external  file  is  opened,  an  index  is  set  that  points  to  the  beginning  of 
the  file.  If  the  APPEND  attribute  is  present  for  a  sequential  or  text  file,  data  transfer  commences  at  the 
end  of  the  file.  For  a  direct  access  file,  the  value  of  the  index  is  set  to  one  more  than  the  number  of 
records  in  the  external  file. 

The  APPEND  attribute  is  not  applicable  to  terminal  devices. 
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F  8.2.8  The  FORM  Parameter  Attribute  -  Blocking 

This  attribute  has  two  alternative  forms: 

BLOCKING 

or 

NON_BLOCKING 

This  attribute  specifies  the  I/O  system  behavior  when  a  request  for  data  transfer  cannot  be  fulfilled  at 
that  moment.  This  stoppage  may  be  due  to  the  unavailability  of  data,  or  to  the  unavailability  of  the 
external  file  device. 

F  8. 2.8.1  Blocking 

If  the  blocking  attribute  is  set,  the  task  waits  until  the  data  transfer  is  complete,  and  all  other  tasks  are 
suspended  (or  blocked).  The  system  is  busy  waiting. 

The  default  for  this  attribute  depends  on  the  actual  program.  It  is  BLOCKING  for  programs  without  any 
task  declarations  and  it  is  NON_BLOCKING  for  a  program  containing  tasks. 

F  8. 2.8.2  Non-Blocking 

If  the  non-blocking  attribute  is  set,  the  task  that  ordered  the  data  transfer  is  suspended  and  the  other 
tasks  can  execute.  The  suspended  task  is  rescheduled  and  kept  in  a  ready  state  together  with  other  tasks 
in  a  ready  state  at  the  same  priority  level. 

When  the  suspended  task  is  scheduled  again,  the  data  transfer  request  is  reactivated.  If  ready,  the  transfer 
is  activated;  otherwise  the  rescheduling  is  repeated.  Control  returns  to  your  program  after  the  data 
transfer  is  complete. 

F  8.2.9  The  FORM  Parameter  -  Terminal  Input 

The  terminal  input  attribute  takes  one  of  two  alternative  forms: 

TERMINAL_INPUT  =>  LINES, 

TERMINAL_INPUT  =>  CHARACTERS, 

Terminal  input  is  normally  processed  in  units  of  one  line  at  a  time,  where  a  line  is  delimited  by  a  special 
character.  A  process  attempting  to  read  from  the  terminal  as  an  external  file  is  suspended  until  a 
complete  line  has  been  typed.  At  that  time,  the  outstanding  read  call  (and  possibly  also  later  calls)  is 
satisfied. 

The  LINES  option  specifies  line-at-a-time  data  transfer,  which  is  the  default  case. 

The  CHARACTERS  option  means  that  data  transfers  character  by  character,  and  so  a  complete  line  does  not 
have  to  be  entered  before  the  read  request  can  be  satisfied.  For  this  option,  the  BUFrER_SIZE  must  be 
zero. 

The  TERMINAL  INPUT  attribute  is  only  applicable  to  terminal  devices  other  than  the  one  pre-connccted 
to  STANDARD  INPUT  and  STANDARD  OUTPUT. 
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F.9  The  HP  Ada  Compilation  System  and  HP-UX  Signals 

The  HP  Ada  run  time  in  the  HP-9000  Series  300  uses  HP-UX  signals  to  implement  the  following  features 
of  the  Ada  language: 

•"Ada  exception  handling 
•"Ada  task  management 
•"Ada  delay  timing 


F  9.1  HP-UX  Signals  Reserved  by  the  Ada  Run  Time 

The  HP-UX  signals  reserved  by  the  Ada  run  time  are: 

•"SICFPE 

•"SIGILL 

•"SIGBUS 

•"SIGSEGV 

•"SIGEMT 

•"SIGALRM 

•"SIGVTALRM 


WARNING 


The  signals  reserved  for  use  by  the  HP  Ada  run  time  may  be  used  in  your 
Ada  programs  only  with  extreme  caution.  If  you  attempt  to  generate, 
catch,  or  ignore  these  signals,  the  Ada  program  can  produce  unpredictable 
results. 


F  9.2  HP-UX  Signals  Used  for  Hp  Ada  Exception  Handling 

Signals  are  used  to  raise  some  HP  Ada  exceptions.  The  HP  Ada  run  time’s  handlers  for  operating  system 
signals  arc  set  during  the  elaboration  of  the  HP  Ada  run  time.  Defining  a  new  handler  for  any  of  these 
signals  destroys  the  normal  exception  handling  mechanism  of  Ada  and  may  result  in  erroneous  run-time 
execution. 

The  following  signals  are  used  for  exception  handling: 

SIGILL,  SIGFPE,  SIGBUS,  SIGSEGV,  SIGEMT 

F  9.3  HP-UX  Signals  Used  for  Ada  Task  Management 

The  HP-UX  alarm  facility  is  used  by  the  Ada  run  time  for  task  management.  When  the  Ada  program 
contains  tasks,  the  HP-UX  alarm  signal  SIGVTALRM  is  used  to  implement  time  slicing.  In  time  slicing,  the 
Ada  run  time  allocates  the  available  processor  time  among  concurrent  tasks.  If  the  Ada  program  does  not 
contain  tasks,  it  is  a  sequential  program.  The  Ada  run  time  in  sequential  programs  does  not  use  the 
HP-UX  signal  SIGVTALARM. 
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Be  careful  if  you  use  external  routines  that  may  use  HP-UX  signals  reserved  by  the  HP  Ada  run  time  If 
HP-UX  alarm  signals  are  caught,  generated,  or  ignored,  then  interaction  between  external  subprograms 
and  Ada  tasking  can  produce  unpredictable  program  behavior.  If  you  redefine  a  handler  for 
alarm-related  signals,  unexpected  results  may  occur.  For  more  information,  see  the  section  "Potential 
Problems  Using  Interfaced  Subprograms"  (Section  F  1  1. 6). 


F  9.4  HP-UX  Signals  Used  for  Ada  Delay  Timing 

The  HP-UX  alarm  signal  SIGALRM  is  used  by  the  run  time  when  the  Ada  program  contains  DELAY 
statements  to  wait  for  the  delays  to  expire. 

If  HP-UX  alarm  signals  are  used,  interaction  between  external  subprograms  and  Ada  DELAY  statement 
execution  can  produce  unpredictable  program  behavior.  If  you  redefine  a  handler  for  alarm-related 
signals,  unexpected  results  may  occur.  See  the  section  "Potential  Problems  Using  Interfaced  Subprograms" 
(Section  F  1 4. 7). 


F  9.5  Protecting  Interfaced  Code  from  Ada’s  Asynchronous  Signals 

The  two  signals  mentioned  above  (SIGALRM  and  SIGVTALRM)  occur  asynchronously.  Because  of  this,  they 
may  occur  while  your  code  is  executing  an  interfaced  subprogram.  For  details  on  protecting  your 
interfaced  subprogram  from  adverse  effects  caused  by  these  signals,  see  the  section  in  the  HP  Ada  User's 
Guide  on  Interfaced  Subprograms  and  Ada’s  Use  of  Signals." 


F  9.6  HP-UX  Signals  Used  in  Ada  Program  Termination 

Some  HP-UX  signals  cause  the  HP-UX  process  (your  Ada  program)  to  terminate.  These  signals  are 
discussed  in  this  section.  Some  of  these  signals  produce  different  program  behavior  from  others  at 
termination  time.  This  behavior  is  described  below. 


The  following  signals  are  caught  by  the  HP  Ada  run-time  system,  which  resets  the  terminal  to  the 
terminal  configuration  that  was  in  effect  before  the  program  is  executed,  cleans  up  any  locks  that  might 
be  left  by  an  abnormal  termination,  and  terminates  the  Ada  program. 


""""""'"SIGHUP* 

SIGIOT 

SIGTERM* 

SIGPROF 


SIGINT* 

SIGKILL 

SIGUSR1* 

SIGIO 


SIGQUIT* 
SIGSYS 
SIGUSR2* 
SI GDI L 


SICTRAP 

SIGPIPE* 

SIGPWR 

SICWINDOW 


Signals  marked  with  an  *  are  caught  by  the  Ada  run-time  system  only  if  they  are  not  ignored  at  the  time 
the  Ada  program  is  executed.  (See  (signal (2)  in  the  HP-UX  Reference.) 

Your  use  of  signals  to  terminate  an  Ada  program  affects  the  use  of  Ada  I/O.  No  cleanup  of  Ada  I/O  is 
performed  by  the  Ada  run  time  if  a  signal  is  used  to  exit  the  program  unless  you  do  the  cleanup  prior  to 
sending  such  a  signal. 


F  9.7  HP-UX  Exit  Status  and  Signals  in  Ada 

If  an  unexpected  signal  is  received,  the  HP  Ada  run  time  terminates  the  Ada  program  with  a  non-zero 
HP-UX  ex  t  status.  However,  the  run  time  does  not,  in  general,  terminate  the  Ada  program  in  a  manner 
that  follows  HP-UX  conventions.  The  conventional  HP-UX  method  of  program  termination  is  to 
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indicate  the  reason  for  termination  (if  caused  by  a  signal)  in  the  exit  status.  The  HP-UX  convention  u 
adhered  to  only  for  the  signals  listed  in  Section  F  9.  6  (which  cause  termination).  For  other  signals,  the 
exit  status  is  non-zero  but  does  not  indicate  that  the  cause  of  termination  was  a  signal. 


F  9.8  Programming  in  Ada  With  HP-UX  Signals 

If  you  intend  to  utilize  signals  in  interfaced  subprograms,  refer  to  the  section  on  "Potential  Problems  Using 
Interfaced  Subprograms"  (Section  F  14  7).  This  version  of  the  product  does  not  support  the  association  of 
an  HP-UX  signal  such  as  SIGINT  with  an  Ada  procedure  or  a  task  entry.  The  signal  must  be  handled 
inside  an  external  subprogram.  The  same  cautions  apply  for  this  external  subprogram  as  for  any  external 
interfaced  subprogram  that  might  be  interrupted  by  an  unexpected  signal. 

Table  F- 1 0  provides  a  summary  of  HP-UX  Signals. 
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Table  F-10.  Summary  of  HP-UX  Signals  and  HP  Ada/300 


HP-UX  Signal 
Number 
and  Name 

Description 

Reserved 

By 

Ada 

Program 

Terminates 

Caught 

If 

Ignored 

(01)  SICHUP 

hangup 

no 

yes 

no 

(02)  SIGINT 

interrupt 

no 

yes 

no 

(03)  SIGQUIT 

quit 

no 

yes 

no 

(04)  SIGILL 

illegal  instruction 

yes 

no 

yes 

(05)  SIGTRAP 

trace  trap 

no 

yes 

yes 

(06)  SIGIOT 

software -generated 

no 

yes 

yes 

(07)  SIGEKT 

sof  tware  -generated 

yes 

no 

yes 

(08)  SIGFPE 

floating  point  exception 

yes 

no 

yes 

(09)  SIGKILL 

kill 

no 

yes 

yes 

(10)  SIGBUS 

bus  error 

yes 

no 

yes 

(11)  SIGSEGV 

segmentation  violation 

yes 

no 

yes 

(12)  SIGSYS 

bad  arg  to  system  call 

no 

yes 

yes 

(13)  SIGPIPE 

broken  pipe 

no 

yes 

no 

(14)  SIGALRM 

alarm  clock 

yes 

no 

yes 

(15)  SIGTERM 

software  termination  signal 

no 

yes 

no 

(16)  SIGUSR1 

user  defined  signal  1 

no 

yes 

no 

(17)  SICUSR2 

user  defined  signal  2 

no 

yes 

no 

(18)  SIGCLD 

death  of  a  child  process 

no 

no 

yes 

(19)  SIGPWR 

power  fail 

no 

yes 

yes 

(20)  SIGVTALRM 

virtual  timer  alarm 

yes 

no 

yes 

(21)  SIGPROF 

profiling  timer  alarm 

no 

yes 

yes 

(22)  SIGIO.SIGDIL 

asychronous  I/O  signal 

no 

yes 

yes 

(23)  SIGWINDOW 

window  or  mouse  signal 

no 

yes 

yes 
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F  11.  Predefined  Language  Pragmas 

The  predefined  language  pragmas  are  implemented  as  defined  in  the  Reference  Manual  for  the  Ada 
Programming  Language,  ,A.ppendix  B,  with  the  following  exceptions  (see  also  "Implementation -Dependent 
Pragmas"  in  this  appendix). 

Use  of  the  predefined  language  pragmas 

CONTROLLED 

MEMORY_SIZE 

OPTIMIZE 

PACK 

STORAGE_UNIT 

SYSTEM_NAME 

is  either  ignored  without  comment  (the  pragma  has  no  effect  as  required  by  the  Reference  Manual  for  the 
Ada  Programming  Language)  or  elicits  this  warning  from  the  compiler: 

This  pragma  is  not  currently  supported  by  the  implementation. 
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F  13.  Limitations 

This  section  describes  limitat’ons  of  the  compiler  and  the  Ada  development  environment. 

F  13.1  Compiler  Limitations 


It  is  impossible  to  give  exact  numbers  for  most  of  the  limits  given  here. 
The  various  language  features  may  interact  in  complex  ways  to  lower  the 
following  limits. 

The  numbers  represent  “hard"  limits  in  simple  program  fragments  devoid  of 
other  Ada  features. 


Limit  Description 

255  Maximum  number  of  characters  in  a  source  line. 

253  Maximum  number  of  characters  in  a  string  literal. 

255  Maximum  number  of  characters  in  an  enumeration  type  element. 

32767  In  an  enumeration  type,  the  sum  of  the  lengths  of  the  IMAGE  attributes  of  all 
elements  in  the  type,  plus  the  number  of  elements  in  the  type,  must  not  exceed  this 
value. 

2047  Maximum  number  of  actual  compilation  units  in  a  library. 

32767  Maximum  number  of  enumeration  elements  in  a  single  enumeration  type  (this  limit 
is  further  constrained  by  the  maximum  number  of  characters  for  all  enumeration 
literals  of  the  type). 

2047  Maximum  number  of  "created"  units  in  a  single  compilation. 

2**3  r- 1  Maximum  number  of  bits  in  any  size  computation. 

2048  Links  in  a  library. 

2048  Libraries  in  the  INSTALLATION  family  (250  of  which  are  reserved). 

2047  Libraries  in  either  the  PUBLIC  or  a  user  defined  family.  (For  more  information,  see 
the  Ada  User's  Guide,  which  discusses  families  of  Ada  libraries  and  the  supported 
utilities  (tools)  to  manage  them). 
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Limit  Description 

Maximum  number  of  tasks  is  limited  only  by  heap  sue. 

The  offset  of  a  record  component  has  to  be  representable  in  lo-bit  integer. 

255  Maximum  number  of  characters  in  any  path  component  of  a  file  specified  for  access 

by  the  Ada  compiler.  If  a  component  exceeds  255  characters,  NAME _ ERROR  will 

be  raised. 

1023  The  maximum  number  of  characters  in  the  entire  path  to  a  file  specified  for  access 
by  the  Ada  compiler.  If  the  size  of  the  entire  path  exceeds  1023  characters, 
NAME _ ERROR  will  be  raised. 

The  pathname  limits  apply  to  the  entire  path  during  and  after  the  resolution  of 
symbolic  links  and  context-dependent  files  (CDFs)  if  they  appear  in  the  specified 
path. 


The  following  items  are  limited  only  by  overflow  of  internal  tables  (AIL  or  HLST  tables).  All  internal 
data  structures  of  the  compiler  which  previously  placed  fixed  limits  are  now  dynamically  created. 

Maximum  number  of  identifiers  in  a  unit.  An  identifier  includes  enumerated  type 
identifiers,  record  field  definitions,  and  (generic)  unit  parameter  definitions. 

Maximum  "structure"  depth.  Structure  includes  the  following:  nested  blocks, 
compound  statements,  aggregate  associations,  parameter  associations,  subexpressions. 

-  Maximum  array  dimensions.  Set  to  Maximum  structure  depth/ 1 0.  * 

-  Maximum  number  of  discriminants  in  a  record  constraint.  * 

Maximum  number  of  associations  in  a  record  aggregate.* 

Maximum  number  of  parameters  in  a  subprogram  definition  * 

Maximum  expression  depth.* 

Maximum  number  of  nested  frames.  Library-level  unit  counts  as  a  frame. 

Maximum  number  of  overloads  per  compilation  unit. 

-  Maximum  number  of  overloads  per  identifier. 


*  A  limit  on  the  size  of  tables  used  in  overloading  resolution  can  potentially  lower  this 
figure.  This  limit  is  set  at  500.  It  reflects  the  number  of  possible  interpretations  of  names 
in  any  single  construct  under  analysis  by  the  compiler  (procedure  call,  assignment 
statement,  etc. ). 
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F  13.2  Ada  Development  Environment  Limitations 

The  following  limits  apply  to  the  Ada  development  environment  (ada.umgr,  ada.fmgr,  Ada  tools). 

Limit  Description 

200  The  number  of  characters  in  the  actual  rooted  path  of  an  Ada  program  LIBRARY  or 
FAMILY  of  libraries. 

200  The  number  of  characters  in  the  string  (possibly  after  expansion  by  an  HP-UX  shell) 
specifying  the  name  of  an  Ada  program  LIBRARY  or  FAMILY  of  libraries.  This  limit 
applies  to  strings  (pathname  expressions)  specified  for  a  LIBRARY  or  FAMILY  that  you 
submit  to  tools  such  as  ada.mklib  or  ada.umgr. 

512  Maximum  length  of  an  input  line  for  the  tools  ada.fmgr  and  ada.umgr. 

255  The  maximum  number  of  characters  in  any  path  component  of  a  file  specified  for 
access  by  an  Ada  development  environment  tool.  If  a  component  exceeds  255 
characters,  NAME _ ERROR  will  be  raised. 

1023  The  maximum  number  of  characters  in  the  entire  path  to  a  file  specified  for  access 
by  an  Ada  program  or  an  Ada  development  environment  tool.  If  the  size  of  the 
entire  path  exceeds  1023  characters,  NAME _ ERROR  will  be  raised. 

The  pathname  limits  apply  to  the  entire  path  during  and  after  the  resolution  of 
symbolic  links  and  context-dependent  files  (CDFs)  if  they  appear  in  the  specified 
path. 
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F  13.3  Limitations  Affecting  User-Written  Ada  Applications 

The  Ada/300  compiler  and  Ada  development  environment  is  expected  to  be  used  on  versions  of  the 
HP-UX  operating  system  that  support  Network  File  Systems  (NFS),  discless  HP-UX  workstations,  long 
filename  file  systems  and  symbolic  links  to  files  To  accomodate  this  diversity  wuhin  a  file  system  used  in 
both  the  development  and  target  systems,  the  HP  Ada  compiler  places  some  restrictions  on  the  use  of  the 
OPEN  and  CREATE  on  external  files.  This  section  describes  those  restrictions. 


F  13.3.1  Restrictions  Affecting  Opening  or  Creating  Files 

Unless  you  observe  the  following  restrictions  on  the  size  of  path  components  and  file  names,  the  OPEN  or 
CREATE  call  will  raise  NAME  ERROR  in  certain  situations. 


F  13.3.2  Restrictions  on  Path  and  Component  Sizes 

The  maximum  number  of  characters  in  any  path  component  of  a  file  specified  for  access  by  an  Ada 
program  is  25S. 

The  maximum  number  of  characters  in  the  entire  path  to  a  file  specified  for  access  by  an  Ada  program  is 
1023. 

The  pathname  limits  apply  to  the  entire  path  during  and  after  the  resolution  of  symbolic  links  and 
context-dependent  files  (CDFs)  if  they  appear  in  the  specified  path. 


F  13.3.3  Conditions  that  Raise  NAME_ERROR 

When  using  OPEN  and  CREATE,  the  Ada  exception  NAME _ ERROR  will  be  raised  if  any  path  component 

exceeds  255  characters  or  if  the  entire  path  exceeds  1023  characters. 

When  opening  a  file,  the  Ada  exception  NAME _ ERROR  will  be  raised  if  there  are  any  directories  in  the 

rooted  path  of  the  file  that  arc  not  readable  by  the  "effective  uid"  of  the  program.  This  restriction  applies 
to  intermediate  path  components  that  are  encountered  during  the  resolution  of  symbolic  links. 
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F  14.  Calling  External  Subprograms  From  Ada 

In  the  HP  implementation  of  Ada,  subprogram  parameters  of  external  interfaced  subprograms  are  passed 
on  the  stack  in  reverse  order  of  their  declaration.  The  first  parameter  appears  at  the  top  of  the  stack. 
This  same  ordering  is  used  by  HP  for  other  language  products  on  the  HP  9000  Series  300  family  of 
computers.  The  languages  described  in  Section  14  of  this  Appendix  are  HP  implementations  of  680X0 
Assembler,  C,  FORTRAN  77,  and  Pascal  on  the  HP-UX  Series  300  systems. 

In  some  cases,  the  interface  requires  not  only  the  parameters  but  additional  information  to  be  pushed  on 
the  stack  as  well.  This  information  may  include  a  parameter  count,  a  return  result  pointer,  or  other 
bookkeeping  information.  When  you  specify  the  interfaced  language  name,  that  name  is  used  to  select 
the  correct  calling  conventions  for  supported  languages.  Then,  subprograms  written  in  HP'C, 
HP'FORTRAN'77,  and  HP'Pascal  interface  correctly  with  the  HP  Ada  subprogram  caller. 

Section  F  14  contains  detailed  information  about  calling  subprograms  written  in  these  languages.  If  the 
subprogram  is  written  in  a  language  from  another  vendor,  you  must  follow  the  standard  calling 
conventions. 

In  the  HP  Ada  implementation  of  external  subprogram  interfaces,  the  three  Ada  parameter  passing  modes 
(IN,  OUT,  IN  OUT)  are  supported,  with  some  limitations  as  noted  below.  Scalar  and  access  parameters  of 
mode  IN  are  passed  by  value.  All  other  parameters  of  mode  IN  are  passed  by  reference.  Parameters  of 
mode  OUT  or  IN  OUT  are  always  passed  by  reference.  (See  Table  F- 1 3  and  Figure  F- 1 . ) 


Table  F-13.  Ada  Types  and  Parameter  Passing  Modes 


Ada  Type 

Mode  Passed 
By  Value 

Mode  Passed 

By  Reference 

SCALAR, 

ACCESS 

IN 

OUT,  IN 'OUT 

All  others  except 

TASK  and  RXED 
POINT  (REAL) 

IN,  OUT,  IN'OUT 

TASK  and  FIXED 
POINT  (REAL) 

(not  passed) 

(not  passed) 

The  values  of  the  following  types  cannot  be  passed  as  parameters  to  an  external  subprogram: 

Task  types  (LRM  Section  9.  1,  9.2), 

Fixed  point  types  (LRM  Section  3.  5. 9,  3.  5.  1 0). 

A  composite  type  (an  array  or  record  type)  is  always  passed  by  reference  (as  noted  above).  A  component  of 
a  composite  type  is  passed  according  to  its  type  classification  (scalar,  access,  or  composite). 

Only  scalar  types  (enumeration,  character,  boolean,  integer,  or  real)  or  access  types  are  allowed  for  the 
result  returned  by  an  external  function  subprogram. 
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NOTE 


There  are  no  checks  for  consistency  between  the  subprogram  parameters  (as 
declared  in  Ada)  and  the  corresponding  externa]  subprogram  parameters. 
Because  external  subprograms  have  no  notion  of  Adas  parameter  modes, 
parameters  passed  by  reference  are  not  protected  from  modification  by  an 
external  subprogram.  Even  if  the  parameter  is  declared  to  be  only  of  mode 
IN  (and  not  OUT  or  IN  OUT)  but  is  passed  by  reference  (that  is,  an  array  or 
record  type),  the  value  of  the  Ada  actual  parameter  can  still  be  modified. 

The  possibility  that  the  parameter’s  actual  value  will  be  modified  by  an 
interfaced  external  subprogram  exists  when  that  parameter  is  not  passed  by 
value.  Objects  whose  attribute  'ADDRESS  is  passed  as  a  parameter  and 
parameters  passed  by  reference  are  not  protected  from  alteration  and  are 
sublet  to  modification  by  the  external  subprogram.  In  addition,  such 
objects  will  have  no  run-time  checks  performed  on  their  values  upon 
return  from  interfaced  external  subprograms. 

Erroneous  results  may  occur  if  the  parameter  values  are  altered  in  some 
way  that  violates  Ada  constraints  for  the  actual  Ada  parameter.  The 
responsibility  to  ensure  that  values  are  not  modified  in  external  interfaced 
subprograms  in  such  a  manner  as  to  subvert  the  strong  type  and  range 
checking  enforced  by  the  Ada  language  is  yours. 


CAUTION 


Be  very  careful  to  establish  the  exact  nature  of  the  types  of  parameters  to 
be  passed.  The  bit  representations  of  these  types  can  be  different  between 
this  implementation  of  Ada  and  other  languages,  or  between  different 
implementations  of  the  same  language.  Stacked  values  must  occupy  equal 
space  in  the  two  interfaced  languages.  When  passing  record  types,  pay 
particular  attention  to  the  internal  organization  of  the  elements  of  a  record 
because  Ada  semantics  do  not  guarantee  a  particular  order  of  components. 
Moreover,  Ada  compilers  are  free  to  rearrange  or  add  components  within  a 
record.  (See  Section  F  1  2.  on  data  type  layout  for  more  information. ) 
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F  14.1  General  Considerations  in  Passing  Ada  Types 

Section  F  14.  1  discusses  each  data  type  m  general  terms.  Sections  F  14  2  through  F  14  5  describe  the 
details  of  interfacing  your  .A.da  programs  with  external  subprograms  written  in  HP'C,  HP'FORrRAN'2", 
HP'Pascal.  Section'F'  1  4  6  provides  summary  tables. 

The  Ada  type.c  are  described  in  the  following  order; 

•"Scalar 

•"Integer 

•"Enumeration 

•"Boolean 

•"Character 

•"Real 

•"Access 

•"Array 

•"Record 

•"Task 


F  14.1.1  Scalar  Types 

This  section  describes  general  considerations  when  you  are  passing  scalar  types  between  Ada  programs  and 
subprograms  written  in  a  different  HP  language.  The  class  scalar  types  includes  integer,  real,  and 
enumeration  typei  Because  character  and  boolean  types  are  predefined  Ada  enumeration  types,  they  are 
also  scalar  types. 

Scalar  type  parameters  of  mode  IN  are  passed  by  value.  Scalar  type  parameters  of  mode  IN  OUT  or  OUT 
are  passed  by  reference. 
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F  14.1.1.1  Integer  Types 

In  HP  Ada,  all  integers  are  represented  in  two's  complement  form.  SHORT_SHORT_INTEGERS  are 
represented  as  8-bit  numbers,  SHORT_INTEGERS  are  represented  as  16-bit  numbers,  and  INTEGERS  are 
represented  as  32 -bit  numbers. 

All  integer  types  can  be  passed  to  interfaced  subprograms.  When  an  integer  is  used  as  a  parameter  for  an 
interfaced  subprogram,  the  call  may  be  made  either  by  reference  or  by  value.  For  a  call  by  reference,  the 
value  of  the  actual  integer  parameter  is  not  copied  or  modified,  but  a  32-bit  address  pointer  is  pushed  on 
the  stack.  For  a  call  by  value,  a  copy  of  the  actual  integer  parameter  value  is  pushed  on  the  stack,  with 
sign  extension  as  necessary  to  satisfy  the  requirements  of  the  external  subprogram.  See  Sections 
F'14.  2. 1.  1,  F'14.  3. 1.  1,  F'14.4.  1.  I,  and  F'14.  5. 1. 1  for  details  specific  to  interfaced  subprograms  written 
in  different  languages. 

Integer  types  may  be  returned  as  function  results  from  external  interfaced  subprograms. 


F  14.1.1.2  Enumeration  Types 

Values  of  an  enumeration  type  (LRM  3. 5.  U  without  an  enumeration  representation  clause  (.LRM  1 3.  3) 
have  an  internal  representation  of  the  value’s  position  in  the  list  of  enumeration  literals  defining  the  type. 
These  values  are  non -negative.  The  first  literal  in  the  list  corresponds  to  an  integer  value  of  zero. 

An  enumeration  representation  clause  may  be  used  to  explictly  give  the  internal  representation  of  the 
enumeration  value.  A  length  clause  that  specifies  the  size,  usually  8,  16  or  32  bits  also  should  be  used  to 
insure  that  the  size  used  by  the  Ada  compiler  matches  the  sizes  used  by  the  interfaced  subprogram.  See 
lection  4. 1  for  more  information  on  representation  clauses  for  enumeration  types. 

If  no  represenution  clause  applies  to  the  type,  the  values  of  an  enumeration  type  with  less  than  128 
elements  are  represented  as  non -negative  integers  using  eight  bits,  whereas  the  values  of  an  enumeration 
type  with  more  than  128  elements  are  represented  as  non -negative  integers  using  16  bits.  When  passed 
by  value,  the  copy  of  the  integer  is  treated  as  if  it  were  an  unsigned  integer,  with  any  necessary  extension 
up  to  32  bits  to  satisfy  the  requirements  of  the  external  subprogram.  Sec  Sections  F'14.  2.  1. 2,  F' 14.  3. 1. 2, 
F'  1 4.  4. 1.  2,  and  F'  1 4.  5.  1 . 2  for  specific  details. 

Enumeration  types  may  be  returned  as  function  results  from  external  interfaced  subprograms. 


F  14.1.1.3  Boolean  Types 

The  values  of  the  predefined  enumeration  type  BOOLEAN  arc  represented  in  HP  Ada  as  8 -bit  values.  The 
boolean  value  FALSE  is  represented  by  the  8-bit  value  zero,  and  the  boolean  value  TRUE  is  represented  by 

the  8-bit  value  255  (#1 1 1 1 _ 1 1 1 1#).  This  is  not  the  same  as  other  enumeration  types  that  occupy  eight 

bits  in  Ada,  where  the  position  in  the  enumeration  list  at  declaration  defines  the  internal  representation 
for  the  element. 

When  a  boolean  is  passed  by  reference,  its  value  is  not  copied,  but  a  32-bit  address  pointer  is  pushed  on 
the  stack.  When  a  boolean  is  passed  by  value,  a  copy  is  pushed  on  the  stack.  The  Ada  boolean  value 
occupies  one  byte,  and  it  is  up  to  you  to  ensure  that  the  boolean  is  in  a  correct  format  for  the  external 
subprogram. 

Boolean  types  may  be  returned  as  function  results  from  external  interfaced  subprograms,  with  caution  as 
noted  above. 
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See  Sections  F'14.2.1.3,  F'14.3.1.3,  F'14.4  1.3,  and  F'14.5.  1.3  for  information  about  interfaced 
subprograms  written  in  Assembler,  HP'C,  HP'FORTRaN'77,  and  HP'Pascal. 

F  14.1.1.4  Character  Types 

The  values  of  the  predefined  enumeration  type  CHARACTER  are  represented  as  8 -bit  values  in  a  range  0 
through  127. 

character  types  may  be  returned  as  function  results  from  external  subprograms. 


F  14.1.1.5  Real  Types 

Ada  fixed  point  types  and  Ada  floating  point  types  are  discussed  in  the  following  subsections. 

Fixed  Point  Real  Types 

Ada  fixed  point  types  (LRM  3. 5. 9,  3.  5.  1 0)  are  not  supported  as  parameters  or  as  results  of  external 
subprograms. 

Fixed  point  types  cannot  be  returned  as  function  results  from  external  subprograms. 

Floating  Point  Real  Types 

Floating  point  values  (LRM'Sections'3.  5.  7'and'3.  5. 8)  in  the  HP  implementation  of  Ada  are  of  32  bits 
(FLOAT)  or  64  bits  (LONC_FLOAT).  These  two  types  conform  to  the  conventions  defined  in  the  document 
"A  Proposed  Standard  for  Binary  Floating  Point  Arithmetic",  IEEE  P754,  draft  1 0.  0. 

When  passed  by  reference,  a  32-bit  address  pointer  to  the  object  is  pushed  on  the  stack.  When  passed  by 
value,  a  copy  is  pushed  on  the  stack,  possibly  with  extension  to  64  bits  according  to  the  external 
subprogram  interfacing  conventions.  See  Sections  F'l  4. 2.  1. 5,  F'  1 4.  3. 1.  5,  F'  1 4. 4. 1.  5,  and  F'  1 4. 5.  1.5  for 
details  specific  to  interfaced  subprograms  written  in  different  languages. 

Floating  point  types  may  be  returned  as  function  results  from  external  interfaced  subprograms,  with  some 
restrictions. 
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F  14.1.2  Access  Types 

Values  of  an  access  type  (LRM,  Ser»ion  3,  8)  have  an  internal  representation  as  the  3 2 -bit  address  of  the 

underlying  designated  object  (such  as  an  object _ address  stored  in  an  object _ address _ location).  .\n 

access  type's  value  is  an  address  pointer  to  the  object.  Therefore,  when  an  access  type  is  passed  by  value,  a 

copy  of  this  32-bit  object _ address  is  pushed  on  the  stack.  If  the  type  is  passed  by  reference,  however,  the 

3  2 -bit  address  pointer  to  the  object _ address _ location  is  pushed  on  the  stack.  This  is  effectively  a 

double  indirect  address  to  the  designated  object.  See  Figure  F-  1. 


Figure  F-1.  Parsing  Access  Types  to  Interfaced  Subprograms 


.Access  types  may  be  returned  as  function  results  from  external  interfaced  subprograms. 

Ada  access  types  are  pointers  to  Ada  objects.  Ada  access  types  to  simple  objects  (scalar  type  or  other  access 
type  objects)  are  actually  pointers  to  the  designated  object.  Ada  access  type  values  pointing  to  composite 
types  (record  or  array  types)  are  pointen  to  Ada  descriptors  for  that  object,  rather  than  pointers  to  the 
actual  object. 


CAUTION 


The  descripton  used  by  Ada  are  not  identical  to  descriptors  used  by  other 
languages.  Therefore,  an  Ada  access  type  value  that  points  to  a  composite 
type  may  have  no  meaning  or  may  have  a  different  meaning  when  passed  as 
a  parameter  to  a  subprogram  written  in  another  language. 


B-77 


Implementation -Dependent  Characteristics 


F  14.1.3  Array  Types 

In  the  HP  implementation  of  Ada.  arrays  (LRM.  Section  3  o)  are  always  passed  by  reference  The  value 
pushed  on  the  stack  is  the  address  of  the  first  element  of  the  array  When  an  array  is  passed  as  a 
parameter  to  an  external  interfaced  subprogram,  the  usual  checks  on  the  consistency  of  array  bounds 
between  the  calling  program  and  the  called  subprogram  are  not  enforced.  You  are  responsible  for 
ensuring  that  the  external  interfaced  subprogram  keeps  within  the  proper  array  bounds 

Values  of  the  predefined  type  STRING  (LRM,  Section  3  6.  3)  are  a  special  case  of  arrays  and  are  passed  as 
described  above.  The  address  of  the  first  character  in  the  string  is  pushed  on  the  stack.  Returning  strings 
from  an  external  interfaced  subprogram  to  Ada  requires  special  handling  because  the  descriptors  for  string 
types  differ  between  Ada  and  other  languages.  This  restriction  also  applies  to  Ada  strings  that  are  passed 
as  OUT  parameters  to  interfaced  subprograms. 

Array  element  allocation,  layout,  and  alignment  are  described  in  Section  F  12  of  this  appendix.  Array 
types  cannot  be  returned  as  function  results  from  external  interfaced  subprograms. 


F  14.1.4  Record  Types 

Records  (LRM  3.7)  are  always  passed  by  reference  in  the  HP  implementation  of  Ada,  pushing  the  32-bit 
address  of  the  first  component  of  the  record  on  the  stack. 

Unlike  arrays,  however,  the  individual  components  of  a  record  may  have  been  reordered  internally  by  the 
Ada  compiler.  This  means  that  the  implementation  of  record  components  can  be  in  an  order  different 
from  the  declarative  order.  Ada  semantics  do  not  require  a  specific  ordering  of  record  components. 

You  can  control  the  layout  of  individual  record  components  by  using  record  representation  clauses. 
However,  in  the  absence  of  a  complete  record  specification,  the  exact  internal  structure  of  a  record  in 
memory  cannot  be  known  directly  at  the  time  of  coding  (see  Section  F  1 2).  The  attnbute  '  POS  can  be 
used  to  locate  the  offset  of  a  record  component  with  respect  to  the  surting  address  of  the  record.  By 
passing  such  a  record  component  offset  to  a  called  subprogram  (in  addition  to  passing  the  record),  Ada 
record  components  may  be  directly  accessed  by  an  interfaced  subprogram.  Offsets  are  relative  to  the 
starting  address  of  the  record.  The  starting  address  of  the  record  is  denved  from  the  following: 

•"the  record  passed  as  a  parameter  (records  are  always  passed  by  reference). 

•"the  attribute  'ADDRESS  of  the  record  passed  as  a  parameter. 

•"an  access  to  the  record  passed  as  a  parameter. 

Direct  assignment  to  a  discriminant  of  a  record  is  not  allowed  in  Ada  (LRM,  Section  3.7.1).  A 
discriminant  cannot  be  passed  as  an  actual  parameter  of  mode  OUT  or  IN  OUT.  This  restriction  applies 
equally  to  HP  Ada  subprograms  and  to  external  interfaced  subprograms  written  in  other  languages.  If  an 
interfaced  program  is  given  access  to  the  whole  record  (rather  than  individual  components),  that  code 
should  not  change  the  discriminant  value.  Record  element  allocation,  layout,  and  alignment  are  described 
in  Section  F  1 2. 

In  HP  Ada,  records  are  packed  and  variant  record  parts  are  overlaid;  the  size  of  the  record  is  the  longest 
variant  part.  If  a  record  contains  discriminants  or  composite  components  having  a  dynamic  size,  the 
compiler  may  add  implicit  components  to  the  record.  These  components  can  include  a  variant  index, 
record  or  component  size,  and  portions  of  array  descriptors. 

Dynamic  components  and  components  whose  size  depends  upon  record  discriminant  values  are 
implemented  indirectly  within  the  record  by  using  descriptors. 
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Record  types  cannot  be  returned  as  function  results  from  external  interfaced  subprograms. 


F  14.1.5  T ask  T ypes 

Task  types  canr  be  passed  to  an  external  procedure  or  function  as  parameters  in  HP  .\da  Task  types 
cannot  be  re'j'iied  as  function  results  from  external  interfaced  subprograms 

The  HP  implementation  of  tasking  in  Ada  uses  asynchronous  HP-UX  signals.  The  asynchronous  signals 
SIGALRM  and  SIGVTALRM  are  used  by  the  Ada  run  time  in  the  HP  **000  Series  300  implementation.  If  an 
externa!  subprogram  called  within  a  tasking  Ada  mam  subprogram  is  interrupted  either  by  SIGALRM  or 
SIGVTTALRM  while  executing  an  HP-UX  primitive,  problems  may  arise.  (See  Section  9,  "The  HP  Ada 
Compilation  System  and  HP-UX  Signals",  for  more  information.)  You  must  therefore  disable  SIGALRM 
and  SIGVTALRM  before  any  HP-UX  primitive  is  called  from  within  the  external  interfaced  subprogram 
written  in  a  language  different  from  Ada.  SIGALRM  and  SIGVTALRM  must  be  re-enabled  after 
completion  of  the  execution  of  the  primitive,  and  the  SIGALRM  and  SIGVTALRM  interrupt  cycle  should 
then  be  resurted  using  the  HP-UX  routine  alarm. 

An  alternative  method  of  protecting  interfaced  code  from  signals  is  described  in  the  Ada  User's  Guide 
section  on  execution-time  topics.  Two  procedures,  SUSPEND_ADA_TASKINC  and  RESLIME_ADA_T ASKING, 
from  the  HP  supplied  package  UNIX_ENV  can  be  used  to  access  signal  protection  primitives  inside  Ada 
programs.  Calls  to  these  routines  could  be  used  within  an  Ada  program  to  surround  a  critical  section  of 
Ada  code  or  a  call  to  external  interfaced  subprogram  code  that  contains  a  critical  section. 

See  Sections  F  9  and  F  1 4.  7  for  more  deuil  on  the  suggested  handling  of  these  signals. 
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F  14.2  Calling  Assembly  Language  Subprograms 

When  calling  interfaced  assembly  language  subprograms,  specify  the  named  external  subprogram  in  a 
compiler  directive: 

pragma  INTERFACE  (ASSEMBLER,  Ada_subprog rxim_name). 

Note  that  the  language _ type  specification  is  ASSEMBLER  and  not  ASSEMBLY  This  description  refers  to 

the  HP  assembly  language  for  the  MCbSOxO  microprocessor  family  (68K.  assembly  language)  upon  which 
the  Series  300  family  is  based. 

When  calling  interfaced  68K  assembly  language  subprograms,  scalar  and  access  parameters  of  mode  IN  are 
passed  by  value;  the  value  of  the  parameter  object  is  copied  and  pushed  on  the  stack.  All  other  types  of 
IN  parameters  (array,  records)  and  parameters  of  mode  OUT  and  IN  OUT  are  passed  by  reference;  the 
address  of  the  parameter  object  is  pushed  on  the  stack. 

When  calling  68K  assembly  language  subprograms,  the  processor  scratch  registers  art  considered  to  be  AO, 
Al,  DO,  or  Dl.  In  external  interfaced  68K  assembly  subprograms,  processor  registers  D2  through  D7,  and 
A2  through  A7  must  be  saved  on  entry  and  restored  before  returning  to  the  Ada  caller.  The  Ada 
compiler  expects  those  registers  to  be  unchanged  across  a  call  to  an  external  interfaced  subprogram.  Only 
registers  used  in  the  called  68K  assembly  language  subprogram  must  be  saved  and  restored,  but  you  are 
responsible  for  ensuring  that  all  register  contents  (except  for  designated  scratch  registers)  are  unchanged. 

The  results  returned  by  external  function  subprograms  are  expected  to  be  in  the  register  DO  if  the  result  is 
scalar,  or  in  register  AO  if  the  result  is  an  access  value.  L0NC_rL0AT  values  that  are  represented  as 
64-bits  are  returned  in  two  registers:  DO  holds  the  low-level  word  and  Dl  holds  the  high  level  word. 

Only  scalar  types  (integer,  floating  point,  character,  boolean,  and  enumeration  types)  and  access  types  are 
allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in  68K  assembly  language. 

For  more  information  on  68K  assembly  language  interfacing,  see  the  HP-UX  Assembler  Reference 
Manual  and  ADA  Tutorial,  the  MC68020  32-Bit  Microprocessor  User's  Manual,  and  the  MC68881 
Floating-Point  Coprocessor  User's  Manual. 


F  14.2.1  Scalar  Types  and  Assembly  Language  Subprograms 

Scalar  types  include  integer,  real,  and  enumeration  types.  The  predefined  enumeration  types  CHARACTER 
and  BOOLEAN  are  also  scalar  types.  This  section  discusses  things  you  should  consider  when  passing  scalar 
types  to  and  from  interfaced  68K  assembly  language  subprograms. 


F  14.2.1.1  Integer  Types  and  Assembly  Language  Subprograms 

When  passed  by  value  to  an  assembler  subprogram,  values  of  type  INTEGER  and  SHORT_INTEGER  arc 
copied  and  pushed  on  the  stack  without  alteration.  An  Ada  INTEGER  is  stacked  in  a  3 2 -bit  container  (a 
Long  Word  in  68K  assembly  language)  and  an  Ada  SHORT_INTECER  is  stacked  in  a  )6-bit  container  (a 
Word  in  68K  68K  assembly  language).  Values  of  type  SHORT_SHORT_INTEGER  are  copied  and  pushed  on 
the  stack  as  the  most  significant  (leftmost)  8  bits  of  a  16-bit  word;  the  low  order  8  bits  arc  meaningless 
and  should  not  be  accessed. 


B-80 


Implementation -Dependent  Characteristics 


When  passed  by  reference,  the  value  is  not  altered  and  a  32-bit  address  pointer  to  the  integer  object  is 
pushed  on  the  stack. 

Table  F-14  summarizes  the  integer  correspondence  between  Ada  and  HP  assembly  language. 


Table  F-14.  HP  Ada/68K' Assembly  Language  Integer  Correspondence 


Ada 

68K' Assembly  Language 

Bit  Length 

SHORT_SHORT_I NTECER 

Byte 

8 

SHORT_INTEGER 

Word 

16 

INTEGER 

Long  Word 

32 

All  integer  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in  68K 
assembly  language.  The  results  returned  by  external  function  subprograms  are  expected  to  be  in  the 
register  DO  if  the  result  is  an  integer  type,  or  in  register  AO  if  the  result  is  an  access  to  an  integer  value. 


F  14.2.1.2  Enumeration  Types  and  Assembly  Language  Subprograms 

When  passed  by  value  to  an  assembler  subprogram,  values  of  enumeration  types  represented  by  16  bits  are 
copied  and  pushed  on  the  stack  without  alteration.  Values  of  enumeration  types  represented  by  8  bits  arc 
copied  and  pushed  on  the  stack  as  the  most  significant  (leftmost)  8  bits  of  a  16 -bit  word;  the  low  order  8 
bits  are  meaningless  and  should  not  be  accessed. 

When  passed  by  reference,  the  value  is  not  altered  and  a  32 -bit  address  pointer  to  the  enumeration  object 
is  pushed  on  the  stack. 

Enumeration  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in 
68K  assembly  language.  The  results  returned  by  external  function  subprograms  are  expected  to  be  in  the 
register  DO  if  the  result  is  an  enumeration  type,  or  in  register  AO  if  the  result  is  an  access  to  an 
enumeration  value. 


F  14.2.1.3  Boolean  Types  and  Assembly  Language  Subprograms 

Although  a  predefined  enumeration  type,  Ada  boolean  values  are  represented  in  8  bits  in  a  manner 
different  from  '^ther  enumeration  types  in  the  HP  implementation  of  Ada  .  The  internal  representation 

of  FALSE  corresponds  to  2#0000 _ 0000#  and  TRUE  corresponds  to  2#1 1 1 1 _ 1 1 1 1#  (that  is,  all  zeros  or 

all  ones  in  8  bits).  Note  that  the  value  of  BOOLEAN 'POS (TRUE)  is  1  and  the  value  of 
BOOLEAN 'POS( FALSE)  is  0. 

When  passed  by  value  to  an  interfaced  68K  assembly  language  subprogram,  values  of  type  BOOLEAN  arc 
copied,  and  pushed  on  the  stack  as  the  most  significant  (leftmost)  8  bits  of  a  16-bit  word;  the  low  order  8 
bits  are  meaningless  and  should  not  be  accessed. 


When  passed  by  reference  to  an  interfaced  6  8K  assembly  language  subprogram,  the  boolean  value  is  not 
altered  and  a  32-bit  address  pointer  to  the  object  is  pushed  on  the  stack. 
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Boolean  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in  6  8K. 
assembly  language,  when  care  is  taken  to  observe  the  internal  representation.  The  results  returned  by 
external  function  subprograms  are  expected  to  be  in  the  register  DO  if  the  result  is  a  boolean  type,  or  in 
register  AO  if  the  result  is  an  access  to  a  boolean  value. 


F  14.2.1.4  Character  Types  and  Assembly  Language  Subprograms 

Character  types,  which  are  predefined  enumeration  types,  are  represented  as  8  bits  in  the  HP 
implementation  of  Ada.  When  passed  by  value  to  an  interfaced  subprogram  written  in  68K  assembly 
language,  values  of  type  CHARACTER  are  pushed  on  the  stack  as  the  most  significant  (leftmost)  8  bits  of  a 
16-bit  word;  the  low  order  8  bits  are  meaningless  and  should  not  be  accessed. 

When  passed  by  reference  to  an  interfaced  subprogram  written  in  68K  assembly  language,  the  character 
values  are  not  altered  and  a  32-bit  pointer  to  the  address  of  the  character  object  is  pushed  on  the  stack. 

Character  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in  68K 
assembly  language.  The  results  returned  by  external  function  subprograms  are  expected  to  be  in  the 
register  DO  if  the  result  is  a  character  type,  or  in  register  AO  if  the  result  is  an  access  to  a  character  value. 


F  14.^. 1.5  Real  Types  and  Assembly  Language  Subprograms 

When  passed  by  value  to  interfaced  subprograms  written  in  68K  assembly  language,  values  of  type  FLOAT 
and  LONG_FLOAT  are  copied  and  pushed  on  the  stack  without  alteration.  Specifically,  Ada  objects  of  type 
FLOAT  are  copied  as  a  68K  assembler  Long  Word  (32  bits)  and  Ada  LONG_FLOAT  objects  are  copied  as  two 
68K  assembler  Long  Words  (64  bits). 

When  passed  by  reference  to  an  interfaced  subprogram  written  in  68K  assembly  language,  the  values  are 
not  altered  and  a  3  2 -bit  address  of  the  object  is  pushed  on  the  stack. 

Floating  point  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  wr:tten  in 
68K  assembly  language.  The  results  returned  by  external  function  subprograms  are  expected  to  be  in  the 
register  DO  if  the  result  is  a  FLOAT  type.  If  the  results  returned  by  external  function  subprogra  i.s  arc 
LONG_FLOAT  type,  the  results  are  expected  to  be  contained  in  the  register  DO  and  Dl.  The  low  -  evel 
word  is  in  DO  and  the  high-level  word  is  in  Dl.  The  result  will  be  returned  in  register  AO  if  the  rei  ilt  is 
an  access  to  a  FLOAT  or  LONG  FLOAT  value. 


F  14.2.2  Access  Types  and  Assembly  Language  Subprograms 

See  general  comments  on  parameter  passing  in  Section  F  1 4. 1 .  2. 

Access  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in  68K 
assembly  language.  The  results  returned  by  external  function  subprograms  are  expected  to  be  in  the 
register  AO  if  the  result  is  an  access  value. 


F  14.2.3  Array  Types  and  Assembly  Language  Subprograms 

See  general  comments  on  parameter  passing  in  Section  F  1 4. 1 . 3. 

Array  types  cannot  be  returned  as  function  results  from  external  interfaced  subprograms. 
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F  14.2.4  Record  Types  and  Assembly  Language  Subprograms 

See  general  comments  on  parameter  passing  in  Section  F  14  14. 

Record  types  cannot  be  returned  as  function  results  from  external  interfaced  subprograms. 


I 


F  14.2.5  Task  Types  and  Assembly  Language  Subprograms 

Task  types  cannot  be  passed  as  parameters  in  HP  Ada.  Task  types  cannot  be  returned  as  function  results 
from  external  subprograms. 
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F  14.3  Calling  HP'C  Subprograms 

When  calling  interfaced  HP'C  subprograms,  the  form 

pragma  INTERFACE  (C,  Ada_subprogram_name) 

IS  used  to  identify  the  need  for  HP'C  parameter  passing  conventions. 

To  call  the  following  HP'C  subroutine  (assuming  call  by  value  parameter  passing): 

void  c__sub  (parm) 
int  parm; 

{ 

} 

Ada  requires  an  interfaced  subprogram  declaration: 

procedure  C  SUB  (PARM1  :  in  INTEGER); 
pragma  INTERFACE  (C,  C_SUB); 

The  external  name  specified  in  the  Ada  interface  declaration  can  be  any  Ada  identifier.  No  special 
handling  of  leading  underscores  is  required  as  this  is  handled  by  the  compiler  to  conform  to  standard 
calling  conventions.  Pragma  INTERFACE  ensures  that  the  underscore  required  in  front  of  the  HP'C 
subroutine  name  is  correctly  prepended  by  the  compiler.  Pragma  INTERFACE_NAME  is  required  if  the 
Ada  identifier  diffen  from  the  HP'C  subprogram  name.  ~ 

Note  that  the  parameter  in  the  preceding  example  may  be  of  mode  IN  or  mode  IN 'OUT.  In  HP'C,  user 
parameters  may  be  passed  by  value  or  by  reference. 

When  calling  interfaced  HP'C  subprograms,  scalar  and  access  parameters  of  mode  IN  are  passed  by  value; 
the  value  of  the  parameter  object  is  copied  and  pushed  on  the  stack.  All  other  types  of  IN  parameters 
(array,  records)  and  parameten  of  mode  OUT  and  IN  OUT  are  passed  by  reference;  the  address  of  the 
parameter  object  is  pushed  on  the  stack. 

In  general,  parameters  passed  to  HP'C  subprograms  from  HP  Ada  programs  are  passed  m  32 -bit 
containers,  except  for  64-bit  real  quantities.  Real  values  stored  in  32  bits  and  real  values  stored  in  64 
bits  are  passed  intact  as  parameters  between  external  interfaced  subprograms  written  in  HP'C  and  your 
Ada  program.  The  capability  to  automatically  extend  32-bit  real  types  (Ada  FLOAT)  to  64-bit  values 
when  passed  as  parameters  is  not  supported  by  the  HP  Ada  compiler. 

Only  scalar  types  (integer,  floating  point,  character,  boolean,  and  enumeration  types)  and  access  types  are 
allowed  for  the  result  returned  by  an  external  interfaced  function  subprogram  written  in  HP'C. 

When  binding  and  linking  Ada  programs  with  interfaced  subprograms  written  in  HP'C,  the  libraries 
libc.a  and  libm.a  are  usually  required.  The  mother  program  ada(l)  will  automatically  provide  the 
-Ic  -Im  directives  to  the  linker.  You  are  not  required  to  specify  "-Ic  -Im"  when  binding  the  Ada 
program  on  the  ada  command  line. 

For  more  information  about  C  Language  interfacing,  see  the  following  manuals;  HP-UX  Concepts  and 
Tutorials:  Programming  Environment,  the  HP-UX  Concepts  and  Tutorials  Device  I/O  and  User 
Interfacing,  and  the  HP-UX  Portability  Guide.  For  more  general  information  about  passing  Ada  types,  see 
Section  1 4.  1. 
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F  14.3.1  Scalar  Types  and  HP'C  Subprograms 

Scalar  types  are  a  class  of  .\da  types  that  includes  integer,  real,  and  enumeration  types.  Character  and 
boolean  types  are  also  scalar  types  because  they  are  predefined  enumeration  types.  This  section  discusses 
passing  scalar  types  between  .'>Lda  programs  and  subprograms  written  in  HP'C. 

Scalar  type  parameters  of  mode  IN  are  passed  by  value.  Scalar  type  parameters  of  mode  OUT  or  IN  OUT 
are  passed  by  reference. 


F  14.3.1.1  Integer  Types  and  HP'C  Subprograms 

When  passed  by  value  to  an  HP'C  subprogram,  all  integer  values  are  extended  to  32  bits  to  conform  to  the 
HP'C  parameter  passing  conventions.  HP  Ada  INTEGER  (32  bits)  types  passed  by  value  are  pushed  onto 
the  stack  without  alteration.  Values  of  type  SHORT_SHORT_INTEGER  (8  bits)  and  tyjie  SHORT_INTEGER 
(1 6  bits)  are  sign  extended  (on  the  left)  to  32  bits  and  pushed  on  the  stack. 

When  passed  by  reference,  the  integer  values  are  not  changed;  the  original  values  are  not  sign  extended  to 
32  bits.  The  32-bit  address  pointer  to  the  integer  object  is  pushed  on  the  stack. 

When  passing  integers  by  reference,  note  that  an  Ada  SHORT_SHORT_INTEGER  (8  bits)  has  no  equivalent 
integer  representation  in  HP'C. 

Table  F- 1 5  summarizes  the  integer  correspondence  between  Ada  and  C. 


Table  F-15.  HP  Ada/HP'C  Integer  Correspondence 


Ada 

HP'C 

Bit  Length 

SHORT_SHORT_I NTEGER 

no  equivalent  representation 

8 

SHORT_INTEGER 

short  and  short  int 

16 

INTEGER 

int,  long,  and  long  int 

32 

If  a  SHORT  SHORT_INTEGER  is  passed  by  reference  from  HP  Ada  to  HP'C,  the  external  subprogram  must 
treat  the  reference  as  being  a  pointer  to  char,  and  not  as  a  pointer  to  short.  Otherwise  an  Ada 
SHORT_SHORT_INTEGER  cannot  be  meaningfully  accessed  by  HP'C  subprograms  as  any  type  of  integer. 
Because  HP'C  permits  integer  operations  on  objects  of  type  char,  an  Ada  SHORT_SHORT_INTECER  can  be 
used  and  modified  (as  an  object  of  type  char)  in  an  interfaced  subprogram. 

All  Ada  integer  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in 
HP'C  if  care  is  taken  with  respect  to  differences  in  the  interpretation  of  8-bit  quantities. 
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F  14.3.1.2  Enumeration  Types  and  HP'C  Subprograms 

When  HP  Ada  passes  Ada  enumeration  types  by  value  to  an  HP'C  subprogram,  the  enumeration  types  are 
treated  as  the  underlying  integer  value.  That  value  is  either  an  8-bit  quantity  or  a  Ib-bit  quantity  (see 
Section  F  12)  and  is  passed  according  to  the  convention  given  previously  for  integer  values.  \X  hen  passed 
by  value,  the  integer  is  copied  to  the  stack  and  is  automatically  extended  to  32  bits. 

When  passed  by  reference,  the  value  is  not  altered  by  sign  extension  and  a  32-bit  address  pointer  to  the 
enumeration  object  is  pushed  on  the  stack. 

Enumeration  types  in  HP'C  are  represented  in  the  same  way  as  in  Ada,  except  that  the  values  are  always 
expressed  as  16-bit  integers  (no  matter  how  many  elements  there  are).  When  HP'C  passes  enumeration 
types  as  value  parameters,  the  values  are  extended  to  32  bits,  with  the  high  order  16  bits  disregarded. 
Ada’s  automatic  extension  to  32  bits  means  that  Ada  enumeration  type  values  are  in  the  correct  form  for 
HP'C  subprograms  whether  stored  in  8  or  1 6  bits. 

When  passed  by  reference,  the  original  values  are  not  extended.  Therefore  Ada’s  8-bit  enumeration 
objects  have  no  representation  in  HP'C  and  cannot  be  used  directly  by  an  HP'C  subprogram.  However,  an 
Ada  8-bit  enumeration  value  passed  by  reference  to  HP'C  can  be  accessed  as  a  character  in  C  (using 
pointer-to-char).  Because  HP'C  permits  integer  operations  on  objects  of  type  char,  an  Ada  8-bit 
enumeration  value  passed  by  reference  to  HP'C  can  be  successfully  used  and  modified  by  HP'C  (as  an 
object  of  type  char).  Enumeration  types  are  allowed  for  the  result  returned  by  an  external  interfaced 
subprogram  written  in  HP'C. 


F  14.3.1.3  Boolean  Types  and  HP'C  Subprograms 

The  type  boolean  is  not  defined  in  HP'C,  and  the  HP  Ada  representation  of  booleans  does  not  correspond 
to  any  type  in  HP'C.  Ada  booleans  can  be  converted  to  integers  and  then  passed  to  external  interfaced 
subprograms  written  in  HP'C. 

In  Ada,  BOOLEAN 'POS (TRUE)  has  a  result  of  type  UNIVERSAL_INTECER  with  a  value  of  one  and 
BOOLEAN 'POS( FALSE)  has  a  result  of  type  UNIVERSAL_INTEGER  with  a  value  of  zero.  Thus  the  Ada 
attribute  'POS  can  be  used  to  convert  an  Ada  boolean  type  to  an  integer  type.  The  integer  type  can  then 
be  passed  to  an  HP'C  external  subprogram. 

Boolean  types  are  represented  internally  as  an  8-bit  enumeration  type  of  the  predefined  type  (FALSE, 
TRUE).  Although  a  predefined  enumeration  type,  Ada  boolean  values  are  represented  in  8  bits  in  a 
manner  different  from  other  enumeration  types  in  the  HP  implementation  of  Ada  .  The  internal 

representation  of  FALSE  corresponds  to  2#0000_0000#  and  TRUE  corresponds  to  _ 1111#  (that 

is,  all  zeros  or  all  ones  in  8  bits).  Note  that  the  value  of  BOOLEAN 'POS (TRUE)  is  1  and  the  value  of 
BOOLEAN 'POS (FALSE)  is  0.  Thus  Ada  booleans  could  also  be  passed  as  enumeration  types  in  the  same 
way  as  they  are  passed  as  integer  types.  To  ensure  portability,  however,  passing  the  'POS  of  a  boolean 
type  as  an  integer  is  recommended. 

Boolean  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in  HP'C, 
when  care  is  taken  to  observe  the  internal  representation. 


B-86 


Implementation -Dependent  Characteristics 


F  14.3.1.4  Character  Types  and  HP'C  Subprograms 

Ada  character  types  (including  the  predefined  type  CHARACTER)  correspond  exactly  with  the  type  char  in 
HP'C.  Both  the  Ada  and  HP'C  types  have  the  same  internal  representation  and  size. 

Character  types  are  represented  as  8  bits  in  the  HP  implementation  of  .Ada.  When  passed  by  value  to  an 
interfaced  subprogram  written  in  HP'C,  values  of  type  character  are  zero  extended  on  the  left  to  32  bits 
and  pushed  on  the  stack;  the  actual  value  is  the  low-order  (rightmost)  8  bits. 

When  passed  by  reference,  the  character  values  are  not  altered  and  a  3 2 -bit  address  of  the  character 
object  IS  pushed  on  the  stack. 

Character  values,  whether  passed  by  value  or  reference  to  HP'C,  can  be  used  directly  by  the  interfaced 
subprogram  as  values  of  type  char  (using  pointer-to-char  when  passed  by  reference). 

Character  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in 
HP'C. 


F  14.3.1.5  Real  Types  and  HP'C  Subprograms 

This  section  discusses  passing  fixed  point  types  and  floating  point  types  to  HP'C. 

Fixed  Point  Real  Types 

Ada  fixed  point  types  are  not  supported  as  parameters  or  as  results  of  external  subprograms.  Ada  fixed 
point  types  cannot  be  returned  as  function  results  from  interfaced  subprograms  written  in  HP'C.  For 
information  on  the  Ada  type  STRING,  see  Section'?' 1 4.  3.  3  because  Ada  strings  are  a  special  case  of  arrays 
of  characten. 

Floating  Point  Real  Types 

Both  Ada  and  HP'C  use  the  IEEE  (draft  10.0,  P754)  floating  point  conventions  for  both  32-bit  and 
64-bit  floating  point  real  numben.  The  HP'C  type  float  and  the  Ada  type  FLOAT  are  implemented  on 
32  bits  and  have  both  the  representation  and  length  of  the  IEEE  standard  3 2 -bit  real.  The  HP'C  type 
double  and  the  Ada  type  LONG_FLOAT  are  implemented  on  64  bits.  Both  have  the  representation  and 
length  of  the  IEEE  standard  64-bit  real. 

HP'C  parameter  passing  conventions  require  that  all  32-bit  (that  is,  C  type  float)  values  be  extended  to 
64  bits  (C  type  double)  when  they  are  passed  as  parameters  or  returned  as  results.  The  HP  Ada  compiler 
supports  this  convention  for  Ada  type  LONG_FLOAT,  but  does  not  follow  the  convention  for  .Ada  type 
FLOAT.  Thus  an  Ada  FLOAT  value  may  not  be  passed  by  value  directly  to  HP'C,  nor  returned  from  HP'C. 
An  Ada  FLOAT  value  may  be  passed  by  reference  to  HP'C,  because  C  does  not  expect  such  parameters  to 
be  extended.  A  beneficial  consequence  of  this  restriction  on  3  2 -bit  floating  point  values  is  that  the 
3  2 -bit  HP'C  math  library  is  callable  from  within  Ada  programs. 

When  passed  by  value  to  interfaced  subprograms  written  in  HP'C,  values  of  type  FLOAT  and  LONG  FLOAT 
are  copied,  and  pushed  on  the  stack.  Float  values  stored  in  32  bits  are  pushed  on  the  stack  as  32-bit 
quantities  (without  automatic  extension  to  64  bits)  and  values  stored  in  64  bits  are  pushed  on  the  stack  as 
64-bit  quantities. 

When  passed  by  reference  to  an  interfaced  subprogram  written  in  HP'C,  the  original  values  are  not  altered 
and  a  32-bit  address  of  the  object  is  pushed  on  the  stack. 
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The  64-bit  floating  point  type  L0NG_rL0AT  can  be  returned  as  a  result  from  an  external  interfaced 
function  subprogram  written  in  HP'C. 

The  32-bit  floating  point  type  FLOAT  cannot  be  directly  returned  as  a  result  from  an  external  interfaced 
function  subprogram  written  in  HP'C.  It  is  possible  to  pass  Ada  FLOAT  values  to  HP'C  by  value  and  to 
return  Ada  FLOAT  values  from  HP'C  indirectly  if  the  C  routine  uses  a  union  containing  a  float  field 
and  a  long  int  field. 

A  sample  HP'C  function  to  illustrate  this  follows.  This  example  computes  the  square  of  an  Ada  FLOAT 
value.  The  parameter  in  the  C  function  is  declared  to  be  a  union  type  that  matches  the  sue  of  the  .Ada 
FLOAT  being  passed  (32  bits).  The  function  uses  the  float  field  (f)  of  the  union  to  access  the  Ada 
floating  value.  The  function  stores  the  result  in  a  union  of  the  same  type.  It  returns  the  long  int 
field'(i)  of  the  union  that  overlays  (occupies  the  same  storage  as)  the  float  field  .  The  long  int  field 
is  returned  in  a  manner  in  which  Ada  expects  a  FLOAT  function  result  (occupying  32  bits)  to  be  returned. 
Note  that  neither  the  float  field  of  the  union  nor  the  entire  union  should  be  returned.’  (The  former 
would  be  returned  incorrectly  as  a  double  and  the  latter  as  an  HP'C  structured  type  that  would  be 
inconsistent  with  the  expected  Ada  FLOAT  result.) 

The  following  example  indirectly  returns  a  float  result  to  Ada. 

typedef  union  {  float  f;  long  int  i)  ada_float; 

int  aquarait  (pann)  ada  float  para; 

{ 

ada_^float  result; 

result. f  *  pann.f  *  parm.f; 
return  result.!; 

> 


A  sample  Ada  procedure  to  call  this  HP'C  function  is  the  following: 

--example  to  workaround  restriction  on  Ada  FLOAT  result 

with  TEXT_IO; 

procedure  SQUARE_PI  is 

pi  :  constant  FLOAT  : =3. 1415926; 

pi2  :  FLOAT; 

package  FLOATER  is  new  TEXT_I O.FLOAT_IO( FLOAT) ; 

function  SQUARE  (  f  :  FLOAT)  return  FLOAT; 

pragma  INTERFACE  (C,  SQUARE); 

pragma  INTERFACE_NAME  (SQUARE,  "square it" ) ; 

begin  —  SQUARE  PI 
pi2  :=  SQUARE  (pi); 

TEXT  10. PUT  ("Pi  squared  =  "); 

FLOATER. PUT  (pi2); 

TEXT  10. NEW  LINE; 
end  SQUARE  PI;“ 
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F  14.3.2  Access  Types  and  HP'C  Subprograms 

.\da  access  types  are  pointers  to  Ada  objects.  Ada  access  types  to  simple  objects  (scalar  type  or  other  access 
type  objects)  are  actually  pointers  to  the  designated  object.  .\da  access  type  values  pointing  to  composite 
types  (record  or  array  types)  are  pointen  to  Ada  descriptors  for  that  object  rather  than  pointers  to  the 
actual  object. 


NOTE 


You  are  cautioned  that  the  descriptors  used  by  HP  Ada  are  not  identical  to 
descriptors  used  by  HP'C.  An  Ada  access  type  value  that  points  to  a 
composite  type  has  no  meaning  when  passed  as  a  parameter  to  a  subprogram 
written  in  HP'C. 


Ada  access  types  of  mode  IN  are  passed  by  value.  When  an  access  type  is  passed  by  value,  a  copy  of  the 
32-bit  object  address  is  pushed  on  the  stack.  If  the  type  is  passed  by  reference,  however,  a  32-bit  address 
pointer  to  the  object  address  location  is  pushed  on  the  stack.  This  is  effectively  a  double  indirect  address 
to  the  underlying  object.  (See  Figure  F-1  in  Section  14. 1.2). 

Ada  access  types  may  be  returned  as  function  results  from  external  interfaced  subprograms  written  in 
HP'C. 

An  object  designated  by  an  Ada  access  type  can  be  passed  to  an  HP'C  external  subprogram  subject  to  rules 
applicable  to  the  type  of  the  underlying  object. 

F  14,3.3  Array  Types  and  HP'C  Subprograms 

For  more  information,  see  the  comments  on  general  parameter  passing  in  Section  F  14. 1.  3.  Note  that 
Ada  arrays  with  SHORT_SHORT_INTEGER  and  8-bit  enumeration  type  components  do  not  correspond 
directly  to  any  HP'C  array  type.  Such  arrays  can  be  accessed  in  C  as  an  array  of  type  char.  The 
subprogram  must  access  and  modify  such  elements  in  a  manner  appropriate  to  the  actual  Ada  type;  note 
that  an  Ada  8-bit  enumeration  type  has  a  limited  range  (0  through  128).  Arrays  are  not  supported  as 
function  results  from  external  interfaced  HP'C  function  subprograms. 

HP  Ada  strings  are  one  special  case  of  arrays  that  do  not  end  with  an  .\SCI1  null  character  (\000),  as 
required  of  strings  in  HP'C.  You  must  append  a  null  character  to  the  end  of  an  ,\da  stnng,  if  that  string 
is  to  be  sent  to  an  external  interfaced  HP'C  subprogram.  The  excess  null  terminator  character  may  need 
to  be  removed  from  strings  passed  from  HP'C  to  Ada.  Caution  is  required  regarding  the  assignment  of 
unconstrained  strings  into  array  objects  in  Ada.  In  particular,  there  is  a  restriction  that  an  interfaced 
external  subprogram  cannot  directly  return  an  unconstrained  array  (such  as  a  string). 

The  examples  on  the  next  two  pages  illustrate  the  handling  of  strings  in  C  and  in  Ada.  In  the  first 
example,  an  Ada  string  is  passed  to  C,  Note  the  need  to  explicitly  attach  a  null  character  so  that  the  C 
routine  can  locate  the  end  of  the  string. 
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The  HP'C  routine; 

--passing  an  Ada  string  to  a  C  routine 
void  read_ada_str  (var_str) 
char  *var_str; 

{ 

printf  ("C:  Received  value  was  :  %s  \n",  var  str); 


The  Ada  routine: 

Procedure  send_ad8_str  is 

—  Declare  an  interfaced  procedure  that  sends  an 
—  Ada-String  to  a  C-subprograa 
procedure  READ_ADA  STR  (  VAR  STR  ;  STRING); 
pragma  INTERFACE  (C,  READ_ADA_STR) ; 

begin  --  send_ada_str 

--  Test  the  passing  of  an  Ada  string  to  a  C  routine 
READ_AOA_STR  (  "Ada  teat  string  sent  to  C  "  4  ASCII, NUL); 

end  send  ada  str  ; 


In  the  second  example,  a  C  string  is  passed  to  Ada.  Note  the  need  for  Ada  to  determine  the  length  of  the 
string  parameter  explicitly  by  using  a  brute  force  loop  that  reads,  counts,  and  compares  each  character 
while  looking  for  the  end  of  the  C  string.  The  length  is  required  because  Ada  needs  a  string  of  the  correct 
length  into  which  it  can  assign  the  characten.  Fortunately,  Ada  supports  the  allocation  of  such  a  string 
(of  arbitrary  but  fixed  length)  at  run  time. 

The  HP'C  routine; 

--  Reading  a  variable  length  string  from  a  C  function 
char  eread  c_str() 

{ 

char  elocal^string; 

local_atring  *  "a  C  string  for  Ada."; 
return  local  string; 

} 
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The  Ada  routine: 

with  text  io; 

Procedure  read_cstring  is 

--  Maximum  size  string  expected  from  C  func. 

MAX  SIR  SIZE  :  constant  :=  255  ; 

subtype  MAX_STR  is  STRING  (  1  ..  MAX_STR_SIZE  ); 
type  ACC  STR  is  access  MAX_STR; 

READ_STR“:  ACC_STR; 

--  Declare  an  interfaced  procedure  that  returns  a  pointer 
--  to  a  C  string  (actually  a  pointer  to  a  character) 
function  READ  C  STR  return  ACC  STR; 
pragma  INTERFACE  (C,  READ_C_STR); 

C_STR1NG_LENGTH  :  NATURAL  :=  0  ;  --set  length 

--initially  to  zero 

begin  --  read_cstring 

--  Read  an  unconstrained  string  from  a  C  function  that  returns 

—  a  variable  length,  null  terminated  string  of  characters. 

—  assign  the  pointer  to  the  C  string  to  a  statically  sired 
--  Ada  string  access,  so  both  point  to  same  storage. 

READ_STR  :=  READ_C_STR  ; 

--  calculate  the  length  of  the  C  string  excluding  null  terminator 
while  (READ  STR. all  (  C  STRING  LENGTH  +  1)  /=  ASCII. NUL)  loop 
C_STRINC_LENGTH  ;=  C_STRING_LENGTH  +  1; 
end  loop; 

declare  --  block 

--  allocate  an  Ada  string  of  exactly  the  right  length 
--  to  hold  the  C  string  (excluding  the  null  terminator) 

ADA_STRING  :  STRING  (1..  C_STRING_LENGTH ) ; 

begin  --  block 

--  copy  the  string  from  C  storage  to  Ada  storage 
ADA_STRING  :=  READ_STR.all  (  1  ..  C_STRINC_LENCTH  ); 

--  print  the  string 

TEXT_IO.Pirr_LINE  ("Ada  read:  "  k  ADA_STRING  ); 
end;  --  block 
end  read  cat  ring  ; 
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F  14.3.4  Record  Types  and  HP'C  Subprograms 

For  more  information,  see  comments  on  general  parameter  passing  in  Section  F  14  1.4  Ada  records  may 
be  passed  as  parameters  to  external  interfaced  subprograms  written  in  HP'C  if  care  is  taken  regarding  the 
record  layout  and  access  to  record  discriminant  values.  See  Section  F  12  for  more  information  on  record 
type  layout. 

Record  types  cannot  be  returned  as  function  results  from  external  interfaced  subprograms  written  in 
HP'C. 


F  14.3.5  Task  Types  and  HP'C  Subprograms 

Task  types  cannot  be  passed  as  procedure  or  function  parameters  in  HP  Ada.  Task  types  cannot  be 
returned  as  function  results  from  external  interfaced  subprograms  written  in  HP'C. 
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F  14.4  Calling  HP'FORTRAN'77  Language  Subprograms 

When  calling  interfaced  HP'FORTRAS'T ~  subprograms,  the  following  form  is  used; 

pragma  INTERFACE (FORTRAN,  Adajsubprogram_name) 

This  form  is  used  to  identify  the  need  for  HP'FORTRAN'77  parameter  passing  conventions 

To  call  the  HP'FORTRAN'77  subroutine 

Subroutine  FSUB  (Parm) 

Integer*4  Parm 

end 

you  need  this  interfaced  subprogram  declaration  in  Ada: 

procedure  FSUB  (PARH1  :  in  out  INTEGER); 
pragma  INTERFACE  (FORTRAN,  FSUB); 

The  external  name  specified  in  the  Ada  interface  declaration  can  be  any  Ada  identifier.  If  the  Ada 
identifier  differs  from  the  FORTRAN'77  subprogram  name,  pragma  INTER!  ACE_NAME  is  required.  No 
special  handling  of  leading  underscores  is  required  as  this  is  handled  by  the  compiler  to  conform  to 
standard  calling  conventions.  The  pragma  ensures  that  the  underscore  required  in  front  of  the 
HP'FORTRAN'77  subroutine  name  is  correctly  inserted  by  the  compiler. 

Note  that  the  parameter  in  the  example  above  must  be  of  mode  IN  OUT.  In  HP'FORTRAN'77,  all  user 
parameters  must  be  passed  by  reference.  The  HP'FORTRAN'77  compiler  creates  some  implicit 
parameters  that  are  passed  by  value  not  by  reference. 

Only  scalar  types  (integer,  floating  point,  boolean,  and  character  types)  are  allowed  for  the  result  returned 
by  an  external  interfaced  function  subprogram  written  in  HP'FORTRAN'77.  Boolean  and  access  type 
results  are  not  supported. 

The  FORTRAN  libraries  libITT.a  and  libFTT.a  are  required  when  linking  Ada  programs  that  contain 
external  interfaced  subprograms  written  in  FORTRAN  on  the  HP  9000  Series  300  implementation  of 
Ada.  This  may  be  done  by  including  the  following  options  in  the  ada(1)  command  line.  '’-1177 
-1F77''.  Note  that,  unlike  the  optional  requirement  for  HP'C  interfaced  subprograms,  the 
HP'FORTRAN'77  options  must  be  inserted  by  the  user.  The  ada(1)  mother  program  does  not 

automatically  search  the  HP'FORTRAN'77  libraries  as  the  program  searches  the  HP'C  libraries. 

For  more  information,  see  the  following  manuals: 

•"FORT RAN/ 9000  Reference 
•"FORTRAN??  Programming  with  HP  Computers 
•"HP-UX  Portability  Guide 

For  general  information  about  passing  types  to  interfaced  subprograms,  see  Section  14.  1. 
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F  14.4.1  Scalar  Types  and  HP'FORTRAN'77  Subprograms 

This  section  describes  considerations  when  passing  scalar  types  between  .\da  programs  and  subprograms 
written  in  HP'FORTRAN'7''.  Scalar  types  are  a  class  of  .\da  types  that  includes  integer,  real,  and 
enumeration  types.  Because  character  and  boolean  types  are  predefined  enumeration  types,  they  are  also 
scalar  types. 

All  Ada  scalar  type  parameters  are  passed  by  reference  to  FORTRAN  external  subprograms.  Scalar  type 
parameters  therefore  must  be  declared  as  mode  IN  OUT  to  be  passed  by  reference. 


F  14.4.1.1  Integer  Types  and  HP'FORTRAN'77  Subprograms 

When  passing  parameters  to  an  HP'FORTRAN'77  language  subprogram,  all  scalar  parameters  (which 
includes  integer  parameters)  must  be  declared  as  IN  OUT  parameters  in  the  Ada  program  to  conform  to  the 
HP'FORTRAN'77  parameter  passing  conventions.  Then,  the  parameters  will  be  passed  by  reference.  A 
3 2 -bit  address  pointer  to  the  integer  object  is  pushed  on  the  stack. 

Table  F-16  summarizes  the  correspondence  between  integer  types  in  HP  Ada  and  HP'FORTRAN'77. 


Table  F-16.  HP  Ada/HP'FORTRAN'77  Integer  Correspondence 


Ada 

- 1 

HP'FORTRAN'77 

Bit  Length 

SHORT_SHORT_INTEGER 

no  equivalent  representation 

8 

SHORT^^INTEGER 

INTEGER*! 

16 

INTEGER 

INTEGER* 4 

32 

An  Ada  SHORT  SHORT_INTEGER  (stored  in  8  bits)  has  no  equivalent  integer  representation  in 
HP'FORTRAN'77,  and  is  therefore  incompatible  with  any  HP'FORTRAN"7  integer  value.  Ada  values 
of  type  SHORT_SHORT_INTEGER  must  be  converted  to  a  longer  integer  type  before  being  passed  by 
reference  as  a  parameter  to  an  HP'FORTRAN'77  subroutine. 

The  compatible  types  are  the  same  for  procedures  and  functions.  Compatible  Ada  integer  types  are 
allowed  for  the  result  returned  by  an  external  interfaced  function  subprogram  written  in 
HP'FORTRAN'77. 

Ada  semantics  do  not  allow  parameters  of  mode  IN  OUT  to  be  passed  to  function  subprograms.  Therefore 
for  Ada  to  call  HP'FORTRAN'77  external  interfaced  function  subprograms,  each  scalar  parameter's 
addres  must  be  passed.  The  use  of  the  supplied  package  SYSTEM  facilitates  this  pasnng  of  the  object's 
address.  The  parameters  in  an  HP'FORTRAN'77  external  function  must  be  declared  u  in  the  example  on 
the  following  page: 


B-94 


Impieme  mat  ion -Dependent  Characteristics 


--  Ada  declaration 
with  SYSTEM; 

VAL1  :  INTEGER;  --  a  scalar  type 
VAL2  :  FLOAT  ;  --  a  scalar  type 
RESULT  :  INTEGER; 

function  FTNFUNC  (  PARM1,  PARM2  :  SYSTEM . ADDRESS )  return  INTEGER; 


The  external  function  must  be  called  from  within  Ada  as  follows; 

RESULT  :=  FTNFUNC  (VAL1 'ADDRESS,  VAL2'ADDRESS ) ; 

Because  this  has  the  effect  of  obscuring  the  types  of  the  actual  parameters,  it  is  suggested  that  such 
declarations  be  encapsulated  within  an  INLINED  Ada  body  so  that  the  parameter  types  are  made  visible. 
An  example  follows; 

--  specification  of  function  to  encapsulate 
function  FTNFUNC  (PARM1  :  INTEGER; 

PARM2  :  FLOAT  )  return  INTEGER; 
pragma  INLINE  (FTNFUNC); 

with  SYSTEM; 

--  body  of  function  to  encapsulate 
function  FTNFUNC  (PARM1  :  INTEGER; 

PARM2  :  FLOAT  )  return  INTEGER  is 
function  FORTFUNC  (PI,  P2  :  SYSTEM, ADDRESS)  return  INTEGER; 
pragma  INTERFACE  (FORTRAN,  FORTFUNC); 

begin  --  function  FTNFUNC 

return  FORTFUNC  ( FARM 1' ADDRESS,  PARM2 'ADDRESS ) ; 
end  FTNFUNC; 


In  the  previous  example,  the  name  of  the  interfaced  external  function  subprogram  (written  in 
HP'FORTRAN'77)  is  FORTFUNC.  This  name  is  declared  in  the  following  way: 

Integer*4  FUNCTION  FORTFUNC  (I,  X) 

Integer*4  I 
Real*4  X 

end 


F  14.4.1.2  Enumeration  Types  and  HP'FORTRAN'77  Subprograms 

The  HP'FORTRAN'77  language  does  not  support  enumeration  types.  However,  objects  that  are  elements 
of  Ada’s  enumeration  type  can  be  passed  as  INTEGER  as  the  underlying  integer  representation  of  the 
element.  Then,  those  objects  can  be  used  in  an  HP'FORTRAN'77  routine  as  INTEGER,  similar  to  the  way 
Ada  booleans  are  passed  (for  more  information,  see  the  following  section). 
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F  14.4.1.3  Boolean  Types  and  HP'FORTRAN*77  Subprograms 

In  HP  .\da,  the  type  BCX)LEAN  is  represented  in  8  bits  and  cannot  be  used  as  a  logical  or  short  logical  (that 
IS.  LOGICAL*!)  in  HP'FORTRAN'77.  However,  an  INTEGER  may  be  passed  instead  of  the  boolean  value 
(which  can  be  mapped  to  a  LOGICAL*!). 

Although  a  predefined  enumeration  type,  Ada  boolean  values  are  represented  in  8  bits  in  a  manner 
different  from  other  enumeration  types  in  the  HP  implementation  of  Ada  .  The  internal  representation 

of  FALSE  corresponds  to  2^0000 _ OOOO/i'  and  TRUE  corresponds  to  2#1  1  1 1 _ \\\\0  (that  is,  all  zeros  or 

all  ones  in  8  bits).  Note  that  the  value  of  BOOLEAN 'POS (TRUE)  is  1  and  the  value  of 
BOOLEAN 'POS( FALSE)  is  0. 

The  Ada  attribute  'POS  can  be  used  to  convert  an  Ada  boolean  to  an  integer  type,  which  can  then  be 
passed  to  an  HP'FORTRAN'77  external  subprogram.  Note  that  in  Ada,  BOOLEAN '  POS  (TRUE )  has  a 
result  of  (UNIVERSAL_INTECER)  one,  and  that  BOOLEAN 'POS (FALSE)  has  a  result  of 
(UN1VERSAL_INTEGER)  zero.  This  result  can  then  be  converted  to  an  integer  type  of  16  bits  and 
subsequently  can  be  treated  as  a  LOGICAL*!  in  HP'FORTRAN'77  and  passed  as  a  parameter. 

Likewise,  function  results  of  type  LOGICAL  from  an  HP'FORTRAN'77  function  subprogram  may  be 
considered  in  Ada  as  having  a  SHORT_INTEGER  type  representing  the  position  (attribute  'POS)  of  the 
equivalent  boolean  value. 

For  example,  an  HP'FORTRAN'77  subroutine  of  the  form 

SUBROUTINE  LOGICAL  SUB  (LOGICAL  PARM) 

LOGICAL*2  LOCICAL^PARM 

RETURN 

can  be  called  after  suitable  declarations  in  Ada  as  foUowr. 

subtype  FORTRAN_LOGICAL  is  SHORT_INTEGER ;  --  16  bits 

BVAR  :  BOOLEAN;  --  will  be  input  boolean  value 

—  define  a  place  holder  for  equivalent  integer 
BTEMP  ;  SHORT_INTEGER;  --  integer  on  16  bits 

procedure  BOOL_PROC ( B_PARM  :  in  out  FORTRAN_LOGICAL) ; 

pragma  INTERFACE  (FORTRAN,  BOOL  PROC); 

pragma  INTERFACE_NAME  (  BOOL_PROC,  LOGICAL_SUB) ; 

The  above  subroutine  is  called  from  the  Ada  program  as; 

BTEMP  :*  FORTRAN_LOGICAL( BOOLEAN 'POS (B_VAR) ) ;  --  get  equivalent 
BOOL_PROC(  BTEMP  );  --  the  call  to  the  external 

--  subroutine  LOGICAL  SUB 
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Note  that  the  expression 

BOOLEAN 'POS(B_VAR) 

evaluates  to  a  UNIVERSAL_INTEGER  value  of  one  if  B_VAR  is  TRUE  or  a  UNI VERSAL_INTEGER  value  of 
zero  if  B_VAR  is  FALSE,  while  the  expression  of  the  form 

BTEMP  :=  F0RTRAN_L0G1CAL( . . . ) ; 

is  an  explicit  type  conversion  (on  the  right)  and  assignment  to  a  16-bit  integer  type  (on  the  left)  that  is 
required  to  be  passed  to  map  into  an  equivalent  sized  HP'FORTRAN'77  LOCICAL*2  object. 

Note  that  the  call  from  the  Ada  program  in  the  preceding  example  involved  an  assignment  rather  than  an 
embedded  expression.  An  Ada  restriction  is  that  an  IN  OUT  parameter  must  not  be  an  expression.  So,  the 
following  example  is  not  legal  Ada: 

BOOL_PROC(FORTRAN_LOGICAL(BOOLEAN'POS(B_VAR)));  --  not  legal 

F  14.4.1.4  Real  Types  and  HP'FORTRAN'77  Subprograms 

This  section  discusses  passing  fixed  and  floating  point  types  to  subprograms  written  in  FORTRAN. 

Fixed  Point  Real  Types 

Ada  fixed  point  types  are  not  supported  as  parameters  or  as  results  of  external  interfaced  subprograms 
written  in  HP'FORTRAN'77.  Ada  fixed  point  types  cannot  be  returned  as  function  results  from  external 
interfaced  subprograms  written  in  HP'FOPvTRAN'77. 

Floating  Point  Real  Types 

Parameters  of  type  FLOAT  in  Ada  correspond  to  the  default  REAL  (REAL* 4)  format  in  HP'FORTRAN'77. 
The  Ada  type  LONG  FLOAT  is  equivalent  to  the  HP'FO®TRAN'77  type  DOUBLE  PRECISION  (or  REAL*8). 
HP'FORTRAN'77  follows  the  IEEE  P754  floating  point  conventions  for  both  32-bit  and  64-bit  floating 
point  numbers.  Both  32-bit  real  values  and  64-bit  real  values  can  be  passed  as  parameters. 

A  REAL  value  from  an  HP'FORTRAN'77  external  function  subprogram  may  be  returned  as  a  function 
result  of  type  FLOAT  in  an  Ada  program. 

A  DOUBLE  PRECISION  (or  REAL*8)  value  from  an  HP'FORTRAN'77  external  function  subprogram  may 
be  returned  as  a  function  result  of  type  LONG_FLOAT  in  an  Ada  program. 

When  passed  as  parameters  to  an  interfaced  subprogram  written  in  HP'FORTRAN'77,  the  original  real 
values  are  not  altered  and  a  32-bit  address  of  the  real  object  is  pushed  on  the  stack. 
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F  14.4.2  Access  Types  and  HP'FORTRAN'77  Subprograms 

Ada  access  types  have  no  meaning  in  HP'FORTR.\N'"7  subprograms  because  the  types  are  address 
pointers  to  Ada  objecu.  The  implementation  value  of  an  Ada  parameter  of  type  ACCESS  may  be  passed  to 
an  HP'FORTRAN'77  procedure.  The  parameter  in  HP'FORTRAN'7'’  is  seen  as  INTEGER*4.  The  object 
pointed  to  by  the  access  parameter  has  no  significance  in  HP'FORTRAN'77;  us  value  would  be  useful 
only  for  comparison  operations  to  other  access  values. 

Parameters  or  function  results  of  type  ACCESS  from  external  interfaced  subprograms  written  in 
HP'FORTRAN'77  are  not  supported.  HP'FORTRAN'77  could  return  an  INTEGER  and  the  Ada  program 
can  use  as  the  returned  value  type  INTEGER  (a  matching  sue,  because  HP  Ada’s  INTEGER  is  a  32-bit 
quantity  in  this  implementation).  The  significance  and  use  in  HP'FORTRAN'77  of  such  a  value  must  be 
understood  as  meaningless,  as  mentioned  previously. 


F  14.4.3  Array  Types  and  HP'FORTRAN'77  Subprograms 

For  more  information,  see  the  general  comments  on  parameter  passing  of  arrays  in  Section  F  14. 1.  3. 

Arrays  whose  components  have  an  HP'FORTRAN'77  representation  can  be  passed  as  parameters  between 
Ada  and  interfaced  external  HP'FORTRAN'77  subprograms.  For  example,  Ada  arrays  whose  components 
are  of  types  INTEGER,  SHORT_INTEGER,  FLOAT,  LONG_FLOAT,  or  CHARACTER  may  be  passed  as  parameters. 
Arrays  are  not  supported  as  function  results  from  external  HP'FORTRAN'77  function  lubprograma 


CAUTION 


Arrays  with  multiple  dimensions  are  implemented  differently  in  Ada  and 
HP'FORTRAN'77.  To  obtain  the  same  layout  of  components  in  memory  as 
a  given  HP'FORTRAN'77  array,  the  Ada  equivalent  must  be  declared  and 
used  with  the  dimensions  in  reverse  order. 


Consider  the  components  of  a  2 -row  by  3 -column  matrix,  declared  in  HP'FORTRAN'77  as: 

INTEGER*4  A(2,3)  OR  INTEGER*4  A(1:2,1:3) 

This  array  would  be  stored  by  HP'FORTRAN'77  in  the  following  order 

A(l,1).  A(2,1),  A(1,2),  A(2,2),  A(l,3),  A(2,3) 

This  is  referred  to  as  storing  in  column  major  order,  that  is,  the  first  subscript  varies  most  rapidly,  the 
second  varies  next  mort  rapidly,  and  so  forth,  and  the  last  varies  least  rapidly. 

Consider  the  components  of  a  2 -row  by  3 -column  matrix,  declared  in  Ada  as: 

A  :  array  (1..2,  1..3)  of  INTEGER; 

This  array  would  be  stored  by  Ada  in  the  following  order 

A(1,1),  A(1,2),  A(1,3),  A{2,1),  A(2,2),  A(2,3) 
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This  IS  referred  to  as  storing  in  row  major  order,  that  is  the  last  subscript  vanes  most  rapidly;  the  nest  to 
last  vanes  next  most  rapidly,  and  so  forth,  while  the  first  vanes  least  rapidly.  Clearly  the  two  declarations 
in  the  different  languages  are  not  equivalent.  Now,  consider  the  components  of  a  2-row  by  3 -column 
matrix,  declared  in  .\da  as: 

A  :  array  (1..3,  1..2)  of  INTEGER; 

Note  the  reversed  subscripts  compered  with  the  FORTRAN  declaration.  This  array  would  be  stored  by 
Ada  in  the  following  order: 

A(1,1),  A(1,2),  A(2,1),  A(2.2).  A(3,1).  A(3,2) 

If  the  subscripts  are  reversed,  the  layout  would  be 

A(1,1),  A{2,1),  A(1,2).  A(2.2),  A(1,3).  A(2.3) 

which  is  identical  to  the  HP'FORTRAN'77  layout.  Thus,  cither  of  the  language  declarations  could  declare 
its  component  indices  in  reverse  order  to  be  compatible. 

To  illustrate  that  equivalent  multidimensional  arrays  require  a  reversed  order  of  dimensions  in  the 
declarations  in  HP'FORTRAN'77  and  Ada,  consider  the  following: 

The  Ada  statement 

FOO  :  array  ( 1 . . 10, 1 . .5 , 1 . .3)  of  FLOAT; 

is  equivalent  to  the  HP'FORTRAN'77  declaration; 

REAL«4  F00(3,5,10) 

Or 

REALM  FOO(1:3, 1:5, 1:10) 

Both  Ada  and  HP'FORTRAN'77  store  a  one -dimensional  array  as  a  linear  list. 


F  14.4.4  String  Types  and  HP'FORTRAN'77  Subprograms 

When  a  string  item  is  passed  as  an  argument  to  an  HP'FORTRAN'77  subroutine  from  within 
HP'FORTRAN'77,  extra  information  is  transmitted  in  hidden  (implicit)  parameters.  The  calling  sequence 
includes  a  hidden  parameter  (for  each  string)  which  is  the  actual  length  of  the  ASCII  character  sequence. 
Thu  implicit  parameter  is  pasKd  in  addition  to  the  address  of  the  ASCII  character  string.  The  hidden 
parameter  is  passed  by  value,  not  by  reference. 

These  conventions  are  different  from  those  of  Ada.  For  an  Ada  program  to  call  an  external  interfaced 
subprogram  written  in  HP'FORTRAN'77  with  a  string  type  parameter,  you  must  explicitly  pass  the 
length  of  the  string  object.  The  length  must  be  declared  as  an  Ada  32-bit  integer  parameter  of  mode  IN. 

The  following  example  illustrates  the  declarations  needed  to  call  an  external  subroutine  having  a 
parameter  profile  of  two  strings  and  one  floating  point  variable. 
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procedure  FTNSTR  is 

SA:  STRING! 1 . .6) :=  "ABCDEF”; 

SB:  STRING! 1 . .2) :=  "GH"; 

FLOAT  VAL:  FLOAT :=  1.5; 

LENGTH  SA,  LENGTH  SB  ;  INTEGER; 


procedure  FEXSTR  !  SI  :  STRING; 

F  :  in  out  FLOAT;  --  must  be  IN  OUT 

S2  :  STRING;  --  strings  are  passed  by  r-gference 
LS2  :  in  SHORT_INTEGER ;  --  len  of  string  S2, 

must  be  IN 

LSI  :  in  SHORT_INTEGER  );  --  len  of  string  SI, 


--  must  be  IN 


pragma  INTERFACE  ! FORTRAN,  FEXSTR); 


begin  —  procedure  FTNSTR 
LENGTH  SA  :=  SA' LENGTH; 

LENGTh“S8  :=  SB 'LENGTH; 

FEXSTR!SA,  FLOAT_VAL,  SB,  LENGTH_SA,  LENGTH_SB); 
end  FTNSTR; 


NOTE 


Note  that  the  order  of  the  string  lengths  is  in  the  same  order  of  their 
appearance  in  the  corresponding  parameter  and  that  they  appear  after  all 
other  parameters  (at  the  end  of  the  parameter  list).  The  string  lengths  must 
be  passed  by  value,  not  by  reference. 


The  HP'FORTRAN'77  external  subprogram  is  the  following; 

SUBROUTINE  FEXTR  !S1,  r,  S2) 

CHARACTER  *(*)  SI,  S2 
REAL*4  r 

END 


NOTE 


HP  Ada  does  not  allow  a  string  type  (constrained  or  not)  to  be  returned 
from  a  function  interfaced  with  HP'FORTRAN'77.  Thus,  it  is  not  possible 
to  declare  an  Ada  external  function  that  returns  a  result  of  type  STRING 
(type  STRING  is  an  object  of  type  CHARACTER  *!*)  in  HP'FORTRAN'77). 
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F  14.4.5  Record  Types  and  HP'FORTRAN'77  Subprograms 

There  are  no  record  types  in  HP'FORTRAN'””.  Record  types  cannot  be  passed  as  parameters  in 
MP'rORTRAN'"'.  Function  results  of  type  RECORD  from  external  interfaced  subprograms  written  in 
HP'FORTRAN'77  are  not  supported. 

F  14.4.6  Task  Types  and  HP'FORTRAN'77  Subprograms 

Task  types  cannot  be  passed  as  procedure  or  function  parameters  in  HP  Ada.  Function  results  of  type 
TASK  from  external  interfaced  subprograms  written  in  HP'FORTRAN'77  are  not  supported. 


F  14.4.8  Other  FORTRAN  Types 

The  HP'FORTRAN'77  types  COMPLEX,  COMPLEX*8,  DOUBLE  COMPLEX,  and  COMPLEX*  16  have  no  direct 
counterparts  in  Ada.  However,  it  is  possible  to  declare  equivalent  types  using  either  an  Ada  array  or  an 
Ada  record  type.  For  example,  with  type  COMPLEX  in  HP'FORTRAN'77,  a  simple  Ada  equivalent  is  a 
user-defined  record; 

type  COMPLEX  is  record 
Real  :  FLOAT  :=  0.0; 

Imag  :  FLOAT  0.0; 
end  record; 

Similarly,  an  HP'FORTRAN'77  double  complex  number  could  be  represented  with  the  two  record 
components  declared  as  Ada  type  L0NC_FL0AT. 

While  it  is  not  possible  to  declare  an  Ada  external  function  that  returns  such  a  complex  type,  an  Ada 
procedure  can  be  declared  whose  first  OUT  parameter  is  of  type  COMPLEX.  The  Ada  procedure  would  have 
the  same  functionality  as  the  HP'FORTRAN'77  function,  with  a  different  mechanism  for  returning  the 
result. 
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F  14.5  Calling  HP'Pascal  Language  Subprograms 

Calling  external  interfaced  Pascal  language  subprograms  from  Ada  programs  requires  the  use  of  the 
assembly  language  routines  asm_initproc  and  asn)_wrapup.  Calls  to  these  procedures  must  bracket  the 
program  containing  calls  to  Pascal  routines,  but  only  one  call  to  each  of  these  routines  is  required  per 
program. 

The  first  of  these  calls  must  be  made  to  set  up  Pascal  file  system,  the  Pascal  heap  manager,  and  error 
recovery  (for  the  Pascal  procedures),  and  the  second  to  cleanup  from  the  heap,  the  file  system  and  error 
recovery  usage  that  was  set  up  by  the  previous  call.  Without  placing  these  calls  as  required  the  program 
behavior  may  be  erroneous  or  unpredictable.  For  more  information  on  Pascal  interfacing,  see  the  HP 
Pascal  Language  Reference  Manual,  and  the  section,  "HP-UX  Implementation,  Pascal  and  other 
Languages".  Additional  information  is  available  in  the  HP-UX  Portability  Guide. 

Another  unusual  aspect  of  calling  Pascal  subprograms  (functions  and  procedures)  is  that  these  routines 
cannot  be  compiled  separately  in  Pascal  unless  enclosed  in  a  module  declaration.  The  consequence  of  this 
is  that  the  name  of  the  module  is  prepended  to  the  procedure  or  function  name  with  an  underscore 
character  separating  the  two  identifiers.  This  is  done  by  the  Pascal  compiler,  and  needs  to  be  uken  into 
account  in  the  Ada  calling  program  in  the  pragma  INTERFACE  declaration. 

For  an  external  interfaced  Pascal  subroutine: 

module  modp; 
export 

procedure  subr  (var  parm  :  integer); 
implement 

procedure  subr  (var  parm  ;  integer); 
begin 
•  «  « 
end  ; 
end. 

Note  the  name  of  the  Pascal  external  subprogram  as  viewed  externally  (from  Ada)  includes  module  name 
modp  and  the  procedure  name  subr  formed  into  the  single  identifier  modp_subr.  We  would  require  the 
following  mterfaced  subprogram  declarations  in  Ada; 

type  echo^mode  is  access  INTTGER; 

procedure  MODP_SUBR  (Parmi  :  in  INTEGER); 
pragma  INTERFACE  (Pascal,  MODP_SUBR); 

procedurm  asm_initproc  (echo  :  echo_mode  ); 
pragna  INTERFACE (ASSEMBLER,  asa_initproc) ; 

procedure  a8ffl_wrapup; 

pragma  INTERFACE (ASSEMBLER,  asm  wrapup); 
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to  call  the  external  Pascal  subprogram  : 

apann  :  INTEGER  :*  0; 

echo  :  echo  mode  :=  new  INTEGER' (0); 

noecho  :  echo  mode  ;=  new  INTEGER'(l); 

asm  initproc(echo) ;  --  initialize  heap,  etc 


MODP  SUBR  (aparm);  --  the  call  to  Pascal  procedure 


asm  wrapup;  --  cleanup 


For  Pascal,  scalar  and  access  parameters  of  mode  IN  are  passed  by  value:  the  value  of  the  parameter 
object  is  copied  and  pushed  on  the  stack.  All  other  types  of  IN  parameters  (arrays,  records),  and 
parameters  of  mode  OUT  and  IN  OUT  are  passed  by  reference:  The  address  of  the  object  is  pushed  on  the 
stack.  This  means  that  in  general  Ada  IN  parameters  correspond  to  Pascal  value  parameters  while  Pascal 
VAR  parameters  correspond  to  the  Ada  parameters  of  either  mode  IN  OUT  or  mode  OUT. 

For  Pascal  external  interfaced  subprograms  called  from  an  Ada  program,  all  parameters  are  passed  in 
containers  of  size  32-bits,  except  for  Ada  LONG_FLOAT  parameters  which  are  passed  in  64-bits. 

Only  scalar  types  (integer,  floating  point,  character,  Boolean,  and  enumeration  types)  and  access  types  are 
allowed  for  the  result  returned  by  an  external  interfaced  Pascal  function  subprograms. 


For  general  information  about  passing  parameters  to  interfaced  subprograms,  see  Section  1 4. 1. 
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F  14.5.1  Scalar  Types  and  HP'Pascal  Subprograms 

This  section  discusses  passing  scalar  types  between  Ada  programs  and  subprogram  written  in  HP'Pascal. 
Scalar  types  include  integer,  real,  and  enumeration  types.  Because  character  and  boolean  types  are 
predefined  enumeration  types,  they  are  also  scalar  types. 

Ada  scalar  type  parameters  of  mode  IN  are  passed  by  value.  Scalar  type  parameters  of  mode  OUT  or 
I N '  OUT  are  passed  by  reference. 


F  14.5.1.1  Integer  Types  and  HP'Pascal  Subprograms 

Integer  types  are  compatible  between  Ada  and  HP'Pascal  provided  their  ranges  of  values  are  identical. 
Table  F-1 7  shows  corresponding  integer  types  in  Ada  and  HP'Pascal. 


Table  F-1 7.  Ada/HP'Pascal  Integer  Correspondence 


Ada 

HP'Pascal 

Bit  Length 

predefined  INTEGER 

predefined  INTEGER 

32 

predefined  SHORT_INTEGER 

user-defined  types 
type  116— 32768...  32767; 

16 

predefined  SHORT_SHORT_I  NTEGER 

user-defined  type 
type  I8»  -1  28...  1 27; 

8  (Ada) 

1 6  (Pascal) 

When  passed  by  value  to  an  HP'Pascal  language  subprogram,  all  integer  values  are  extended  to  32  bits  to 
conform  to  the  HP'Pascal  parameter  passing  conventions.  Ada  INTEGER  (32  bits)  types  passed  by  value 
are  pushed  onto  the  stack  without  alteration.  Values  of  type  SHORT_SHORT_INTEGER  (8  bits)  and  type 
SHORT__INTEGER  (16  bits)  are  sign  extended  to  32  bits  and  pushed  on  the  stack. 

When  passed  by  reference,  the  integer  values  are  not  changed;  the  original  values  are  not  sign  extended  to 
32  bits.  A  32-bit  address  pointer  to  the  integer  object  is  pushed  on  the  stack. 

When  passing  integers  by  reference,  note  that  the  predefined  Ada  SHORT_INTEGER  (stored  in  16  bits)  and 
the  Ada  SHORT_SHORT_INTECER  (stored  in  8  bits)  have  no  equivalent  predefined  integer  representations 
in  HP'Pascal  However,  an  HP'Pascal  integer  can  be  declared  whose  range  matches  the  range  of  these 
types.  Note  that  a  difference  in  data  layout  between  the  two  languages  for  the  range  -128  through  127 
places  a  restriction  on  passing  a  SHORT_SHORT_INTEGER  to  Pascal.  For  example,  the  range  and  storage 
size  of  Ada’s  SHORT_INTEGER  corresponds  to  the  range  and  storage  size  of  HP'Pascal  declaration 

type  116  »  -32768  ..  32767  ; 

The  range  of  Ada’s  SHORT_SHORT_INTEGER  corresponds  to  the  range  of  HP'Pascal  declaration 
type  18  »  -128  127  ; 

However,  the  storage  size  is  1 6  bits  in  HP'Pascal  while  it  is  8  bits  in  Ada. 
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All  Ada  integer  types  are  allowed  for  the  result  returned  by  an  external  interfaced  subprogram  written  in 
HP'Pascal,  if  care  is  taken  with  respect  to  ranges  defined  for  integer  quantities.  The  automatic  sign 
extension  helps  in  passing  dissimilar -sized  values  that  are  within  an  acceptable  range. 


F  14.5.1.2  Enumeration  Types  and  HP'Pascal  Subprograms 

Ada  and  HP'Pascal  have  different  implementations  of  enumeration  types.  An  Ada  enumeration  type 
when  passed  as  a  parameter  is  treated  as  if  it  were  the  underlying  integer  representation.  That  value  is 
either  an  8-bit  quantity  (for  enumeration  sizes  <*  128)  or  a  16-bit  quantity  (for  enumeration  sizes  > 
128).  It  is  passed  according  to  the  convention  given  above  for  integer  values.  When  passed  by  value,  the 
integer  is  copied  to  the  stack  and  automatically  extended  to  32  bits.  In  HP'Pascal,  all  enumeration  types 
are  16-bit  quantities,  regardless  of  enumeration  size.  If  care  is  taken  with  respect  to  the  underlying 
representation,  the  automatic  extension  to  32  bits  allows  the  two  implementations  to  treat  enumeration 
types  as  equivalent. 

When  passed  by  reference,  the  original  value  is  not  altered  by  sign  extension  and  a  32-bit  address  pointer 
to  the  enumeration  object  is  pushed  on  the  stack. 

Ada  supports  the  return  of  a  function  result  that  is  an  enumeration  type  from  an  external  interfaced 
function  subprogram  written  in  HP'Pascal. 


F  14.5.13  Boolean  Types  and  HP'Pascal  Subprograms 

Although  a  predefined  enumeration  type,  Ada  boolean  values  arc  represented  in  8  bits  in  a  manner 
different  from  other  enumeration  types  in  the  HP  implementation  of  Ada  .  The  internal  representation 
of  FALSE  corresponds  to  2#0000_0000#  and  TRUE  corresponds  to  2#1 1 1 1_1 1 1 1#  (that  is,  all  zeros  or 
all  ones  in  8  bits).  Note  that  the  value  of  BCX)LEAN'POS(TRUE)  is  1  and  the  value  of 
BOOLEAN 'POS( FALSE)  is  0.  Since  HP'Pascal  treats  boolean  values  differently,  an  Ada  boolean  value  may 
not  be  treated  as  a  Pascal  boolean  value  in  an  external  subprogram,  whether  passed  by  value  or  passed  by 
reference.  The  Ada  attribute  '  POS  can  be  used  to  convert  an  Ada  boolean  type  to  an  integer  type. 

There  is  no  support  for  the  return  of  a  function  result  that  is  a  boolean  type  from  an  external  interfaced 
function  subprogram  written  in  HP'Pascal. 


F  14.5.1.4  Character  Types  and  HP'Pascal  Subprograms 

Values  of  the  Ada  predefined  character  type  may  be  treated  as  the  type  char  in  HP'Pascal  external 
interfaced  subprograms.  Both  the  Ada  and  HP'Pascal  types  occupy  8  bits  and  have  the  same  internal 
representation. 

Character  types  are  represented  as  8  bits  in  the  HP  implementation  of  Ada.  When  passed  by  value  to  an 
interfaced  subprogram  written  in  HP'Pascal,  values  of  type  CHARACTER  are  extended  to  32  bits  and 
pushed  on  the  stack;  the  actual  value  is  the  low -order  (rightmost)  8  bit. 

When  passed  by  reference  to  an  interfaced  subprogram  written  in  HP'Pascal,  the  character  values  are  not 
altered  and  a  3 2 -bit  address  of  the  character  object  is  pushed  on  the  stack. 

Ada  character  values,  whether  passed  by  value  or  reference  to  HP'Pascal,  can  be  used  directly  by  the 
interfaced  subprogram  as  values  of  type  char. 
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Ada  supports  the  return  of  a  function  result  that  is  a  character  type  from  an  external  interfaced  function 
subprogram  written  in  HP'Pascal.  The  HP'Pascal  result  is  of  type  char  while  the  Ada  result  is  of  type 
CHARACTER. 


F  14.5.1.5  Real  Types  and  HP'Pascal  Subprograms 

The  following  subsections  discuss  passing  Ada  real  types  to  interfaced  HP'Pascal  subprograms. 

Fixed  Point  Types 

Ada  fixed  point  types  are  not  supported  as  parameters  or  as  results  of  external  subprograms.  Ada  fixed 
point  types  cannot  be  returned  as  function  results  from  interfaced  subprograms  written  in  HP'Pascal. 

Floating  Point  Real  Types 

HP'Pascal  uses  the  IEEE  P7S4  (draft  10. 0)  floating  point  conventions  for  both  32-bit  and  64-bit  floating 
point  numbers.  Ada  FLOAT  values  correspond  to  HP'Pascal  REAL  values.  Ada  LONG_FLOAT  values 
correspond  to  HP'Pascal  LONGREAL  values. 

In  HP'Pascal,  32-bit  real  values  are  not  automatically  extended  to  64-bit  values  when  passed  as 
parameters  between  external  interfaced  subprograms  written  in  HP'Pascal  and  an  Ada  program.  Both 
32-bit  and  64-bit  real  types  can  be  returned  as  results  from  an  external  interfaced  function  subprogram 
written  in  HP'Pascal. 

When  passed  by  value  to  interfaced  subprograms  written  in  HP'Pascal,  values  of  type  FLOAT  and 
L0NG_FL0AT  are  copied  and  pushed  on  the  stack.  Roat  values  of  32  bits  are  not  automatically  extended 
to  64  bits  when  passed  by  value. 

When  passed  by  reference  to  an  interfaced  subprogram  written  in  HP'Pascal,  the  original  values  are  not 
altered  and  a  32-bit  address  of  the  object  is  pushed  on  the  stack. 


F  14.5.2  Access  Types  and  HP'Pascal  Subprograms 

Ada  access  values  can  be  treated  as  pointer  values  in  HP'Pascal  external  interfaced  subprograms  because 
they  are  address  pointers  to  Ada  objects.  The  Ada  allocation  and  the  HP'Pascal  allocation  are  completely 
separate.  There  must  be  no  explicit  reallocation  in  one  language  of  an  object  allocated  in  the  other 
language. 

An  object  designated  by  an  Ada  access  type  can  be  passed  to  a  HP'Pascal  external  subprogram,  subject  to 
rules  applicable  to  the  type  of  the  underlying  object. 

Ada  access  types  of  mode  IN  are  passed  by  value.  When  an  access  type  is  passed  by  value,  a  copy  of  the 
32-bit  object  address  is  pushed  on  the  stack.  If  the  type  is  passed  by  reference,  however,  a  32-bit  address 
pointer  to  the  object  address  location  is  pushed  on  the  stack.  This  is  effectively  a  double  indirect  address 
to  the  underlying  object.  (See  Figure  F- 1  in  Section  F  1 4.  1. 2. ) 

Ada  access  types  may  be  returned  as  function  results  from  external  interfaced  subprograms  written  in 
HP'Pascal. 
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F  14.5.3  Array  Types  and  HP'Pascal  Subprograms 

Arrays  with  components  with  the  same  representation  have  the  same  representation  in  .'Vda  and 
HP'Pascal. 

Arrays  cannot  be  passed  by  value  from  Ada  to  HP'Pascal.  Only  the  passing  of  arrays  declared  as  a  VAR 
parameter  in  an  HP'Pascal  subprogram  to  an  Ada  program  is  supported. 

Array  types  cannot  be  returned  as  function  results  from  external  interfaced  subprograms  written  in 
HP'Pascal. 

Note  that  the  function  results  of  array  types  are  not  supported  between  HP'Pascal  and  Ada. 
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F  14.5.4  String  Types  and  HP'Pascal  Subprograms 

Passing  variable  length  strings  between  Ada  and  HP'Pascal  is  'U-p.  r'ec  vnth  some  restrictions  The 
parameters  must  be  passed  by  reference  only  HP'Pascal  rr'j-’ram'  must  .le^iare  vAR  parameters  and  the 
Ada  program  must  declare  the  parameters  to  be  of  mode  IN ‘Go''  ’r  GU"'  tv  ensure  passing  b>  reference 

Although  there  is  a  difference  in  the  implementation  of  the  type  STRING  m  the  two  languages  with 
suitable  declarations  you  can  create  compatible  types  to  allow  the  passing  of  both  Ada  strings  and 
HP'Pascal  strings.  An  Ada  string  corresponds  to  a  packed  array  of  characters  in  Pascal  The  following 
example  illustrates  the  declaration  of  compatible  types  for  passing  an  .Ada  string  between  an  Ada  program 
and  an  HP'Pascal  subprogram. 

HP'Pascal  subprogram: 

--  passing  an  Ada  STRING  type  to  an  HP'Pascal  routine  - 

module  p; 
export 

type  atringSO  =  packed  array  (1..0O]  of  char; 
procedure  exl  (  var  s  :  stringSO;  len  ;  integer  ); 
implement 

procedure  ex1; 
begin 

...  (*  update/use  the  Ada  string  as  a  PAC  •) 
and; 
end. 


Ada  program: 

—  Ada  calling  HP'Pascal  procedure  with  Ada  STRING 
procedure  AP_1  ia 

--  Define  Ada  string  corresponding  to  HP'Pascal  packed  array  of  char 
subtype  STRING80  is  STRING  (  1..80  ); 

—  Ada  definition  of  HP'Pascal  procedure  to  be  called,  with  an 
--  Ada  STRING  parameter,  passed  by  reference, 
procedure  P_EX1  (S  :in  out  STRINGSO; 

LEN  :  integer  ); 

pragma  INTERFACE  (PASCAL,  P_EX1); 

--  Define  the  HP'Pascal  initialization  routine  interfaces 
procedure  Pstart  (  arge  :  INTEGER;  argv  :  STRING  ); 
pragma  INTERFACE  (ASSEMBLER,  Pstart  ); 

pragma  INTERFACE  NAME  (  Pstart,  " _ Pstart"  );  --two  underscores 

requ ired 

S  :  STRING80; 


begin  --  AP_1 

Pstart  (  0,  ""  );  --  initialize  HP'Pascal  environment 
S(1..23)  :=  "Ada  to  HP'Pascal  Interface"; 

P_EX1  (S,  23);  --  Call  the  HP'Pascal  subprogram 

end  AP  1 ; 
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An  HP'Pascal  STRING  type  corresponds  to  a  record  in  Ada  that  contains  two  fields:  an  integer  field 
containing  the  string  length,  and  an  Ada  STRING  field  containing  the  string  value  The  following 
example  illustrates  the  declaration  of  compatible  types  for  passing  an  HP'Pascal  string  between  an  Ada 
program  and  a  Pascal  subprogram. 

Pascal  subprogram: 

--  passing  an  HP'Pascal  STRING  type  from  Ada  to  an  HP'Pascal  routine 
module  p; 
expo rt 

type  stringSO  =  string  [80]; 
procedure  ex2  (  var  s  :  stringSO  ); 
implement 

procedure  ex2; 
var 

str  :  stringSO  ; 
begin 

...  --update/use  the  HP'Pascal  string 
end; 

end. 

Ada  program: 

Ada  calling  HP'Pascal  procedure  with  HP'Pascal  STRING 
procedure  AP__2  is 

—  Define  Ada  string  corresponding  to  HP'Pascal  packed  array  of  char 
type  PASCAL_STRING80  is 
record 

LEN  :  INTEGER; 

S  :  STRING  (  1 . .80  ); 
end  record; 

--  Ada  definition  of  HP'Pascal  procedure  to  be  called,  with  a 
--  HP'Pascal  STRING  parameter,  passed  by  reference, 
procedure  P_EX2  (S:in  out  PASCAL  STRINGSO); 
pragma  INTERFACE  (PASCAL,  P_EX2);~ 

--  Define  the  HP'Pascal  initialization  routine  interfaces 
procedure  Pstart  (  argc  :  INTEGER;  argv  :  STRING  ); 
pragM  INTERFACE  (ASSEMBLER,  Pstart  ); 

pragma  INTERFACE_NAME  (  Pstart,  " _ Pstart"  );  --  two  underscores 

PS  :  PASCAL_STRINC80; 
begin  --  AP_2 

Pstart  (  0,  ""  );  --  initialize  HP'Pascal  environment 
PS.S(1..23)  :=  "Ada  to  HP'Pascal  Interface";  --  assign  value  field 
PS. LEN  :=  23;  --  set  string  length  field 

P_EX2  (  PS  ) ;  --  call  the  HP'Pascal  subprogram 

end  AP  2; 
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F  14.5.5  Record  Types  and  HP'Pascal  Subprograms 

See  the  comments  on  general  parameter  passing  in  Section  F  1  4. 1. 4 

Records  cannot  be  passed  by  value  from  Ada  to  HP'Pascal.  Only  the  passing  of  records  declared  as  VAR 
parameters  in  the  HP'Pascal  subprogram  to  Ada  programs  is  supported.  The  record  is  passed  by  reference. 

Record  types  cannot  be  returned  as  function  results  from  external  interfaced  subprograms  written  in 
HP'Pascal. 


F  14.5.6  Task  Types  and  HP'Pascal  Subprograms 

Task  types  cannot  be  passed  as  parameters  in  Ada.  Task  types  cannot  be  returned  as  function  results  from 
external  interfaced  subprograms  written  in  HP'Pascal 


F  14.5.7  Private  Types  and  HP'Pascal  Subprograms 

Private  types  cannot  be  passed  as  parameters  in  Ada,  and  private  types  cannot  be  returned  as  function 
results  from  external  interfaced  subprograms  written  in  HP'Pascal. 
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F  14.6  Summary 

Table  F-  1  8  shows  how  various  Ada  types  are  passed  to  subprograms. 

Table  F-18.  Modes  for  Passing  Parameters  to  Interfaced  Subprograms 


Ada  Type 

Mode 

Passed  By 

ACCESS, 

SCALAR 

-INTEGER 

-ENUMERATION 

-BOOLEAN 

-CHARACTER 

-REAL 

IN 

value 

ARRAY, 

RECORD 

IN 

reference 

all  types  except  TASK  and 
FIXED  POINT  REAL 

IN 'OUT 

reference 

all  types  except  TASK  and 
FIXED  POINT  REAL 

OUT 

reference 

TASK 

FIXED  POINT  REAL 

N/A 

not  passed 
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Table  F-19  summarizes  general  information  presented  in  Section  14  1. 

Tabic  F-19.  Types  Returned  as  External  Function  Subprogram  Results 


Ada  Type 

HP  Assembly 
Language 

1 

HPC 

HP  FORTRAN 

HP  Pascal 

INTEGER 

allowed 

allowed 

allowed 

allowed 

ENUMERATION 

allowed 

allowed 

allowed 

CHARACTER 

allowed 

allowed 

not  allowed 

allowed 

BOOLEAN 

allowed 

allowed 

not  allowed 

REAL  FIXED 

not  allowed 

not  allowed 

not  allowed 

not  allowed 

REAL  FLOAT 

allowed 

allowed 

allowed 

ACCESS 

allowed 

allowed 

allowed 

ARRAY 

not  allowed 

not  allowed 

not  allowed 

not  allowed 

RECORD 

not  allowed 

not  allowed 

not  allowed 

not  allowed 

TASK 

not  allowed 

! 

not  allowed 

not  allowed 

not  allowed 

Notes  for  Table  F- 1 9. 

2  Pass  as  an  integer  equivalent. 

Some  restrictions  apply  to  Ada  FLOAT  types  (in  passing  to  HP  C  subprograms). 
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Table  F- 20  summarizes  information  presented  in  Sections  F  14.  2  through  F  14.  S 

Table  F-20.  Parameter  Passing  in  the  Series  300  Implementation 


Ada  Type 

HP  Assembly 
Language 

HPC 

— 

HP  FORTRAN 

HP  Pascal 

INTEGER 

allowed 

allowed 

allowed 

allowed 

ENUMERATION 

allowed 

allowed 

allowed 

CHARACTER 

allowed 

allowed 

allowed 

allowed 

BOOLEAN 

allowed 

allowed 

not  allowed  ^ 

REAL  FLOAT 

allowed 

allowed 

allowed 

allowed 

REAL  FIXED 

not  allowed 

not  allowed 

not  allowed 

not  allowed 

ACCESS 

allowed 

allowed 

not  allowed 

allowed 

iQjimii 

not  allowed 

allowed 

allowed 

STRING 

not  allowed 

allowed 

not  allowed^ 

RECORD 

not  allowed 

allowed 

not  allowed 

allowed 

TASK 

not  allowed 

not  allowed 

not  allowed 

not  allowed 

2  Can  be  passed  as  an  equivalent  integer  value, 
j  Passed  by  value  only. 

^  Using  only  arrays  of  compatible  component  types, 
j  See  warning  on  layout  of  elements  in  section  for  each  language. 

^  Special  handling  of  null  terminator  character  is  required. 

°  Ada  strings  can  be  passed  to  a  Pascal  PAC  (Packed  Array  of  Characters) 


F  14.7  Potential  Problems  Using  Interfaced  Subprograms 

The  Ada  run-time  executive  for  the  HP  9000  Series  300  computer  uses  signals  in  a  manner  that  generally 
does  not  interfere  with  interfaced  subprograms.  However,  some  HP-UX  routines  are  interruptible  by 
signals.  These  routines,  if  called  from  within  interfaced  external  subprograms,  may  create  problems.  You 
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need  to  be  aware  of  these  potential  problems  when  writing  external  interfaced  subprograms  in  other 
languages  that  will  be  called  from  within  an  Ada  mam  subprogram.  See  sigvector(2)  in  the  HP-L'X 
Reference  for  a  complete  explanation  of  interruptibility  of  operating  system  routines. 

The  following  should  be  taken  into  consideration: 

•"SIGALRM  IS  sent  when  a  DELAY  statement  is  being  timed. 

•"SIGVTALRM  IS  sent  when  round -robin  scheduling  is  used  in  tasking  programs. 

•"There  are  "slow"  HP-UX  routines  (see  s igvector(2))  that  can  be  interrupted  by  signals  generated  by 
the  Ada  run-time  executive.  Therefore  you  must  temporarily  block  these  signals.  These  "slow"  routines 
include  HP-UX  I/O  calls  to  interactive  devices. 

•"No  received  signals  will  be  lost  while  they  are  blocked,  owing  to  the  use  of  HP-UX  reliable  signals. 

•"Any  signals  blocked  in  interfaced  code  must  be  unblocked  before  leaving  interfaced  code  to  return  to 
the  calling  Ada  program. 

The  Ada  run-time  executive  uses  two  time-related  signals  for  control  of  task  scheduling  and  the 
execution  of  DELAY  statements.  The  executive  uses  SIGALRM  to  indicate  the  end  of  a  DELAY  time  interval 
because  SIGALRM  operates  in  real  time.  The  run  time  uses  SIGVTALRM  to  denote  the  end  of  a  task’s  time 
slice  amount,  because  SIGALRM  operates  in  process-local  (virtual)  time. 

These  two  signals  may  cause  problems  in  interfaced  routines  because  the  signals  are  asynchronous  to  the 
external  (interfaced)  code.  Asynchronous  in  this  context  means  that  the  signals  could  occur  at  any 
moment  and  they  are  not  caused  by  the  code  executing  at  the  instant  they  occur.  The  signals  may 
interrupt  some  vulnerable  routines  such  as  the  HP-UX  I/O  calls  mentioned  above. 

The  Ada  run-time  executive  for  the  HP  9000  Series  300  implementation  generates  and  catches  the 
following  HP-UX  signals: 

SIGALRM  --  used  for  DELAY  statements 
SIGVTALRM  —  used  for  task  scheduling 
SIGSECV  --  STORAGE  ERROR 
SIGFPE  —  NUMERIC_ERROR,  Illegal  trap 
SIGEMT  —  unimplemented  instruction 

SIGBUS  --  PROGRAM_ERROR,  User  exception.  Illegal  trap,  Erroneous  instruction 
SIGILL  —  CONSTRAINT_ERROR,  N UMER I C_ERROR,  Illegal  trap 

On  Ada  300,  the  signals  SIGBUS,  SIGSEGV,  and  SIGFPE  can  result  in  the  predefined  Ada  exceptions  listed 
above,  provided  their  associated  trap  number  (see  trapno  (2))  indicates  a  condition  defined  by  these 
exceptions  You  should  not  attempt  to  modify  these  trap  conditions. 


NOTE 


The  signals  SIGALRM  and  SIGVTALRM  are  not  always  generated  in  tasking 
programs.  SIGALRM  is  only  generated  if  and  when  a  DELAY  statement  is 
encountered.  SIGVTALRM  is  only  generated  if  time  slicing  has  not  been 
turned  off  with  the  binder  option  "-W  b,s,0‘'.  Non-tasking  programs  do 
not  use  SIGVTALRM  because  for  such  programs  time  slicing  is  meaningless. 
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Attempts  to  trap  or  ignore  any  of  the  signals  listed  above  (except  as  described  subsequently  and  in  section 
F  9.1)  by  an  interfaced  subprogram  may  have  unpredictable  results.  Subprograms  that  are  part  of  the 
Ada  run-time  executive  are  the  only  exception;  however,  you  have  access  to  only  a  few  such  programs. 
See  the  Ada  User  s  Guide  for  more  details. 

Problems  can  arise  if  an  interfaced  subprogram  initiates  a  "slow"  operating  system  function  that  can  be 
interrupted  by  a  signal  (for  example,  a  read  on  a  terminal  or  a  wait  for  a  child  process  to  complete). 
Problems  can  also  arise  if  an  interfaced  subprogram  can  be  called  by  more  than  one  task  and  is  not 
reentrant.  If  an  Ada  reserved  signal  occurs  during  such  an  operation  or  non-reentrant  region,  the 
program  may  function  erroneously. 

For  example,  an  Ada  program  that  uses  DELAY  statements  and  tasking  constructs  causes  the  generation  of 
SIGALRM  and  SIGVTALRM.  If  an  interfaced  subprogram  needs  to  perform  a  potentially  interruptible 
operating  system  call,  or  if  it  might  be  called  from  more  than  one  task  and  is  not  reentrant,  it  can  be 
protected  by  blocking  SIGALRM  and  SIGVTALRM  around  the  operating  system  call  or  non-reentrant 
region.  If  a  SIGALRM  or  SIGVTALRM  signal  signifying  either  the  end  of  a  delay  period  or  the  need  to 
reschedule  a  task  is  received  while  it  is  blocked,  the  signal  is  not  lost,  but  rather  deferred  until  it  is  later 
unblocked.  The  consequence  of  this  signal  blocking  is  that  Ada  task  scheduling  or  DELAY  sutement 
execution  will  be  affected  for  the  duration  of  the  signal  block. 

Here  is  an  example  of  a  protected  read  (2)  in  an  interfaced  subprogram  written  in  the  C  Language. 

linclude  <signal.h> 
void  interface  rout() 

{ 

long  mask; 


/*  Add  SIGALRM  and  SIGVTALRM  to  list  of  currently 
blocked  signals,  (see  sigblock(2) ) .  */ 

mask  *  sigblock  ((  1L  <<  (SIGALRM-1))  |  (1L  <<  (SIGVTALRM-1 ) ) ) ; 

...  read  (...)  ;  /*  or  non  reentrant  region  */ 

setsigmask  (mask)  ;  /*  return  to  previous  mask  */ 


} 

If  any  Ada  reserved  signal  other  than  SIGALRM  or  SIGVTALRM  is  to  be  similarly  blocked,  SIGALRM  and 
SIGVTALRM  must  be  either  already  blocked  or  blocked  at  the  same  time.  When  any  Ada  reserved  signal 
other  than  SIGALRM  or  SIGVTALRM  is  unblocked,  SIGALRM  and  SIGVTALRM  must  be  unblocked  at  the 
ame  time,  or  as  soon  as  poaible  thereaf ter. 

Any  Ada  reserved  signal  blocked  in  interfaced  code  should  be  unblocked  before  leaving  that  code,  or  as 
soon  as  possible  thereafter,  to  avoid  unnecesarily  stalling  the  Ada  run-time  executive.  Failure  to  follow 
these  guidelines  will  cause  improper  delay  or  tasking  operation. 

An  alternative  method  of  protecting  interfaced  code  from  signals  is  described  in  the  Ada  User's  Guide  in 
the  section  on  "Execution-Time  Topict"  The  two  procedures  SUSPEND_ADA_TASKING  and 
RESUME  ADA  TASKING  from  the  package  UNIX  ENV  supplied  by  HP  can  be  used  within  an  Ada  program 
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to  surround  a  critical  section  of  Ada  code  or  a  call  to  external  interfaced  subprogram  code  with  a  critical 
section. 

F  14.8  Input-Output  From  Interfaced  Subprograms 

Using  I/O  from  interfaced  subprograms  written  in  other  languages  requires  caution.  Some  areas  in  which 
problems  can  arise  are  discussed  in  this  section. 

F  14.8.1  Files  Opened  by  Ada  and  Interfaced  Subprograms 

An  interfaced  subprogram  should  not  attempt  to  perform  I/O  operations  on  files  opened  by  Ada.  Your 
program  should  not  use  HP-UX  I/O  utilities  intermixed  with  Ada  I/O  routines  on  the  same  file.  If  it  is 
necessary  to  perform  I/O  operations  in  interfaced  subprograms  using  the  HP-UX  utilities,  open  and  close 
those  files  with  HP-UX  utilities 


F  14.8.2  Preconnected  I/O  and  Interfaced  Subprograms 

The  standard  HP-UX  files  stdin  and  stdout  are  preconnected  by  Ada  I/O.  If  non -blocking  interactive 
I/O  is  used,  additional  file  descriptors  will  be  used  for  interactive  devices  connected  to  stdin  or  stdout. 
Ada  does  not  preconnect  stderr,  which  is  used  for  run-time  error  messages.  For  more  details,  see  the 
section  on  Ada  I/O  in  the  LRM  and  the  section  on  using  the  Ada  Compilation  system  in  the  Ada  User's 
Manual. 


F  14.8.3  Interactive  I/O  and  Interfaced  Subprograms 

The  default  I/O  system  behavior  is  NON-BLOCKING  for  Ada  programs  with  tasking  and  BLOCKING  for 
sequential  (non-tasking)  Ada  programs  HFs  implementation  of  Ada  sets  up  non-blocking  I/O  by  default 
on  interactive  files  if  the  program  contains  tasks.  If  the  Ada  program  contains  no  task  structures  (that  is, 
it  is  a  sequential  program),  blocking  I/O  is  set  up  on  interactive  files.  You  can  override  the  defaults  with 
binder  options 

The  binder  option  -B  sets  up  blocking  I/O  and  the  binder  option  -b  sets  up  non-blocking  I/O.  In 
non -blocking  I/O,  a  task  (or  Ada  nuin  program)  will  not  block  when  attempting  interactive  input  if  data 
is  not  available.  In  that  case,  the  called  HP-UX  I/O  routine  returns  immediately  to  the  Ada  run  time 
(this  is  the  non -blocking  feature  applied  to  Ada  code  as  the  caller).  The  routine’s  return  allows  the  Ada 
run  time  to  place  the  task  that  requested  I/O  on  a  delay  queue,  and  to  awaken  the  task  when  the  I/O 
operation  is  complete.  This  arrangement  allows  other  tasks  to  continue  execution;  the  task  requesting  I/O 
will  be  delayed  until  the  I/O  operation  is  completed  by  the  Ada  run  time  (on  behalf  of  the  requesting 
task).  However,  if  you  set  up  non-blocking  I/O  on  external  called  subprograms,  the  effect  is  different. 

The  binder  (or  default)  options  set  or  clear  the  0_NDELAY  flag  appropriately  (see  open (2)  in  the  HP-UX 
Reference).  This  affects  both  Ada  I/O  and  HP-UX  I/O  operations.  For  more  information  about  Ada 
binder  options,  see  the  Ada  User's  Manual. 

Attempting  interfaced  subprogram  input  from  the  preconnected  file  stdin  can  produce  unexpected 
results  if  an  Ada  program  with  tasking  is  the  caller  of  the  external  subprogram.  In  this  situation,  since 
the  caller  is  a  tasking  program,  non -blocking  I/O  is  the  default.  For  example,  consider  the  case  of  an 
Ada  call  to  an  interfaced  C  subprogram  that  calls  the  HP-UX  subroutine  g«tchar(3).  The  getchar 
function  may  unexpectedly  receive  a  (-1)  result  because  no  character  may  be  available  on  stdin  at  the 
instant  the  call  is  made  since  non-blocking  I/O  is  in  effect. 
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TEST  PARAMETERS 


Certain  tests  in  the  ACVC  make  use  of  implementation-dependent  values ,  such 
as  the  maximum  length  of  an  input  line  and  invalid  file  names.  A  test  that 
makes  use  of  such  values  is  identified  by  the  extension  .TST  in  its  file 
name.  Actual  values  to  be  substituted  are  represented  by  names  that  begin 
with  a  dollar  sign.  A  value  must  be  substituted  for  each  of  these  names 
before  the  test  is  run.  The  values  used  for  this  validation  are  given 
below. 


Name  and  Meaning 


Value 


$ACC_SIZE  32 

An  integer  literal  whose  value 
is  the  number  of  bits  sufficient 
to  hold  any  value  of  an  access 
type. 


$BIG_ID1  (I..254  =>  'A',  255  =>  M’) 

An  identifier  the  size  of  the 
maximum  input  line  length  which 
is  identical  to  $BIG_ID2  except 
for  the  laist  character. 


$BIG_ID2  (I..254  =>  «A',  255  =>  '2') 

An  identifier  the  size  of  the 
maximum  input  line  length  which 
is  identical  to  $BIG_ID1  except 
for  the  last  character. 

$BIG_ID3  (1..127  =>  'A',  128  =>  '3', 

An  identifier  the  size  of  the  129«»255  =>  *A') 
maximum  input  line  length  which 
is  identical  to  $BIG_ID4  except 
for  a  character  near  the  middle. 
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Name  and  Meaning _ 


$BIG_ID4 

An  identifier  the  size  of  the 
maximum  input  line  length  which 
is  identical  to  $B1G_ID3  except 
for  a  character  near  the  middle. 

$BIG_INT_LIT 

An  integer  literal  of  value  298 
with  enough  leading  zeroes  so 
that  it  is  the  size  of  the 
maximum  line  length. 

$BIG_REAL_LIT 

A  universal  real  literal  of 

value  690.0  with  enough  leading 
zeroes  to  be  the  size  of  the 
maximum  line  length. 

$BIG_STRING1 

A  string  literal  which  when 

catenated  with  BIG_STRIMG2 
yields  the  image  of  BIG__IDl. 

$BIG_STRING2 

A  string  literal  which  when 

catenated  to  the  end  of 
BIG  STRING  1  yields  the  image  of 
BIG^IDI. 

$BLANKS 

A  sequence  of  blanks  twenty 
characters  less  than  the  size 
of  the  naxiraura  line  length. 

$COUNT_LAST 

A  universal  integer 

literal  whose  value  is 

TEXT_I0 . COUNT ' LAST. 

$DEFAULT_MEM_SIZE 

An  integer  literal  whose  value 
is  SYSTEM.MEMORY^SIZE. 

$DEFAULT_STOR_UNIT 

An  integer  literal  whose  value 
is  SYSTEM. STORAGE  UNIT. 


(1..127  =>  ’A',  128  =>  '4', 
129. .255  =>  'A') 


{1..252  =>  'O',  253.. 255  =>  "298") 


(1..249  =>  'O’,  250. .255  =>  "69.0E1") 


(1  =>  2. .128  =>  'A',  129  =>  "”) 


(1  s>  ,  2. .128  =>  'A', 
129  =>  130  =>  '"•) 


(1..235  =>  ’  ') 


2147483647 


2147483647 


8 
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Name  and  Meaning _  Value _ 

$DEFAULT_SYS_NAME  HP9000_300 

The  value  of  the  constant 
SYSTEM . SYSTEM^NAME . 

$DELTA_DOC  2#1.0#E-31 

A  real  literal  whose  value  is 
SYSTEM. FINE_DELTA. 

$FIELD_LAST 

A  .  universal 
literal  whose 

TEXT_I0 . FIELD ' LAST. 

$FIXED_NAME  NO_SUCH_FIXED_TYPE 

The  name  of  a  predefined 
fixed-point  type  other  than 
DURATION. 

$FLOAT_NAME  NO_SOCH_FLOAT_TYPE 

The  name  of  a  predefined 
floating-point  type  other  than 
FLOAT,  SHORT  FLOAT,  or 

LONG^FLOAT. 

$GREATER__THAN_DURATION  1 00000 . 0 

A  universal  real  literal  that 
lies  between  DURATION 'BASE ’LAST 
and  DURATION ' LAST  or  any  value 
in  the  range  of  DURATION. 

$GREATER_THAN_DURATION_BASE_LAST  1 00000000 . 0 

A  universal  real  literal  that  is 
greater  than  DURATION 'BASE 'LAST. 

$HIGH_PRI0RITY  127 

An  integer  literal  whose  value 
is  the  upper  bound  of  the  range 
for  the  subtype  SYSTEM. PRIORITY. 

$ILLEGAL_EXTERNAL_FILE_NAME1  not_there//not  there/*'' 

An  external  file  name  which  ~ 

contains  invalid  characters. 

$ILLEGAL_EXTERNAL_FILE_NAME2  not_there/not_there/not_there/ 

An  external  file  name  which  ././not_there/// 
is  too  long. 

$INTEGER_FIRST  -21474B3648 

A  universal  integer  literal 
whose  value  is  INTEGER 'FIRST. 


255 

integer 
value  is 
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Name  and  Meaning _ Valne  _ 

$INTEGER_LAST  2^H7n83(>‘^l 

A  universal  integer  literal 

whose  value  is  INTEGER 'LAST. 

$INTEGER_LAST_PLUS_1  21^7^83648 

A  universal  integer  literal 

whose  value  is  INTEGER 'LAST  +1. 


$LESS_THAN_DURATION  - 1 00000 . 0 

A  universal  real  literal  that 
lies  between  DURATION 'BASE 'FIRST 
and  DURATION 'FIRST  or  any  value 
in  the  range  of  DURATION. 

$LESS_THAN_DURATION_BASE_FIRST  - 1 00000000 . 0 

A  universal  real  literal  that  is 
less  than  DURATION 'BASE 'FIRST. 


$L0W_PRI0RITY 

An  integer  literal  whose  value 
is  the  lower  bound  of  the  range 
for  the  subtype  SYSTEM. PRIORITY . 


$MANTISSA_D0C  31 

An  integer  literal  whose  value 
is  SYSTEM .MAX_MANTISS A. 

$MAX_DIGITS  15 

Maximum  digits  supported  for 
floating-point  types . 


$MAX_IN__LEN  255 

Maximum  input  line  length 
permitted  by  the  implementation. 

$MAX_INT  2147483647 

A  universal  integer  literal 
whose  value  is  SYSTEM .MAX  INT. 


$MAX_INT_PLUS_1  2147483648 

A  universal  integer  literal 
whose  value  is  SYSTEW.MAX  INT+1. 


$MAX_LEN_INT_BASED_LITERAL  (1..2  =>  "2:", 

A  universal  integer  based  253. -255  =>  " 
literal  whose  value  is  2#n<> 
with  enough  leading  zeroes  in 
the  mantissa  to  be  MAX_IN_LEN 
long. 
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Name  and  Meaning _ _ _ 

$MAX_LEN_REAL_BASED_LITERAL 

A  universal  real  based  literal 
whose  value  is  16;F.E:  with 
enough  leading  zeroes  in  the 
mantissa  to  be  MAX_IN_LEN  long. 

$MAX_STRING_LITERAL 

A  string  literal  of  size 
MAX_IN_LEN,  including  the  quote 
characters . 

$MIN_INT 

A  universal  integer  literal 
whose  value  is  SYSTEM .MIN_INT. 

$MIN_TASK_SIZE 

An  integer  literal  whose  value 
is  the  number  of  bits  required 
to  hold  a  task  object  which  has 
no  entries ,  no  declarations ,  and 
"NULL;"  as  the  only  statement  in 
its  body. 

$NAMS 

A  name  of  a  predefined  numeric 
type  other  than  FLOAT,  INTEGER, 
SHORT  FLOAT,  SHORT_INTEGER, 

L0NG_FL0AT,  or  LONG_INTEGER . 

$NAME_LIST 

A  list  of  enumeration  literals 
in  the  type  SYSTEM. NAME, 
separated  by  commas . 

$NEG_BASED_INT 

A  based  integer  literal  whose 
highest  order  nonzero  bit 

falls  in  the  sign  bit 
position  of  the  representation 

for  SYSTEM. MAX_INT. 

$NEW_MEM_SIZE 

An  integer  literal  whose  value 
is  a  permitted  argument  for 

pragma  MEMORYJSIZE,  other  than 
$DEFAULT_MEM_SIZE.  If  there  is 
no  other  value,  then  use 
$DEFAULT  MEM  SIZE. 


Value  _ _ _ _ _ 

(1..3  =>  "16;",  4. .251  =>  'O’, 
252.. 255  =>  "F.E:") 


(1  =>  2. .254  =>  'A',  255  => 


-2147483648 


32 


SHORT  SHORT  INTEGER 


HP9000  300 


16#FFFFFFFD# 


1048576 


TEST  PARAMETERS 


Name  and  Meaning 


Value 


$NEW_STORJJNIT 

An  integer  literal  whose  value 
is  a  permitted  argument  for 
pragma  STORAGE_UNIT,  other  than 
$DEFAULT_STOR_UNIT.  If  there  is 
no  other  permitted  value,  then 
use  value  of  SYSTEM. STORAGEJJNIT. 


$NEW_SYS_NAME  HP9000_300 

A  value  of  the  type  SYSTEM. NAME, 
other  than  $DEFAOLT_SYS_NAME.  If 
there  is  only  one  value  of  that 
type,  then  use  that  value. 


$TASK_SIZE 

An  intege  •  literal  whose  value 
is  the  number  of  bits  required 
to  hold  a  task  object  which  has 
a  single  entry  with  one  'IN  OUT* 
parameter . 

$TICK 

A  real  literal  whose  value  is 
SYSTEM. TICK. 
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WITHDRAWN  TESTS 


Some  tests  are  withdravm  from  the  ACVC  because  they  do  not  conform  to  the 
Ada  Standard.  The  following  43  tests  had  been  withdrawn  at  the  time  of 
validation  testing  for  the  reasons  indicated.  A  reference  of  the  form 
Al-ddddd  is  to  an  Ada  Commentary. 


a.  E28005C:  This  test  expects  that  the  string  ” —  TOP  OF  PAGE.  — 63"  of 
line  204  will  appear  at  the  top  of  the  listing  page  due  to  a  pragma 
PAGE  in  line  203;  but  line  203  contains  text  that  follows  the  pragma, 
and  it  is  this  text  that  must  appear  at  the  top  of  the  page. 

b.  A39005G;  This  test  unreasonably  expects  a  component  clause  to  pack  an 
array  component  into  a  minimum  size  (line  30). 

c.  B97102E:  This  test  contains  an  unintended  illegality;  a  select 
statement  contains  a  null  statement  at  the  place  of  a  selective  wait 
alternative  (line  31). 

d.  BC3009B:  This  test  wrongly  expects  that  circular  instantiations  will 
be  detected  in  several  compilation  units  even  though  none  of  the  units 
is  illegal  with  respect  to  the  units  it  depends  on;  by  AI-00256,  the 
illegality  need  not  be  detected  until  execution  is  attempted  (line 
95). 

e.  CD2A62D:  This  test  wrongly  requires  that  an  array  object’s  size  be  no 
greater  than  10  although  its  subtype's  size  was  specified  to  be  40 
(line  137). 

f.  CD2A63A..D,  CD2A66A..D,  CD2A73A..D,  and  CD2A76A. .D  (16  tests);  These 

tests  wrongly  attempt  to  check  the  size  of  objects  of  a  derived  type 
(for  which  a  'SIZE  length  clause  is  given)  by  passing  them  to  a 
derived  subprogram  (which  implicitly  converts  them  to  the  parent  type 
(Ada  standard  3«4;14)).  Additionally,  they  use  the  'SIZE  length 
clause  and  attribute,  whose  interpretation  is  considered  problematic 
by  the  WG9  ARG. 


WITHDRAWN  TESTS 


g.  CD2A81G,  CD2A83G,  CD2A84M..N,  and  CD50110  (5  tests):  These  tests 

assume  that  dependent  tasks  will  terminate  while  the  main  program 
executes  a  loop  that  simply  tests  for  task  termination;  this  is  not 
the  case,  and  the  main  program  may  loop  indefinitely  (lines  74,  85, 
86,  96,  and  58,  respectively). 

h.  CD2B15C  and  CD7205C:  These  tests  expect  that  a  'ST0RAGE_SI2E  length 
clause  provides  precise  control  over  the  number  of  designated  objects 
in  a  collection;  the  Ada  standard  13.2:15  allows  that  such  control 
must  not  be  expected. 

i.  CD2D11B:  This  test  gives  a  SMALL  representation  clause  for  a  derived 
fixed-point  type  (at  line  30)  that  defines  a  set  of  model  numbers  that 
are  not  necessarily  represented  in  the  parent  type;  by  Commentary 
AI-00099,  all  model  numbers  of  a  derived  fixed-point  type  must  be 
representable  values  of  the  parent  type . 

j .  CD5007B:  This  test  wrongly  expects  an  implicitly  declared  subprogram 
to  be  at  the  address  that  is  specified  for  an  unrelated  subprogram 
(line  303). 

k.  ED7004B,  ED7005C..D,  and  ED7006C..D  (5  tests):  These  tests  check 
various  aspects  of  the  use  of  the  three  SYSTEM  pragmas;  the  AVO 
withdraws  these  tests  as  being  inappropriate  for  validation. 

l.  CLi'IOSA;  This  test  requires  that  successive  calls  to  CALENDAR . CLOCK 
change  by  at  least  SYSTEM. TICK;  however,  by  Commentary  AI-00201,  it  is 
only  the  expected  frequency  of  change  that  must  be  at  least 
SYSTEM. TICK— particular  instances  of  change  may  be  less  (line  29). 

m.  CD7203B  and  CD7204B:  These  tests  use  the  ’SIZE  length  clause  and 
attribute,  whose  interpretation  is  considered  problematic  by  the  WG9 
ARG. 

n.  CD7205D:  This  test  checks  an  invalid  test  objective:  it  treats  the 
specification  of  storage  to  be  reserved  for  a  task's  activation  as 
though  it  were  like  the  specification  of  storage  for  a  collection. 

o.  CE2107I:  This  test  requires  that  objects  of  two  similar  scalar  types 
be  distinguished  when  read  from  a  file — DATA_ERR0R  is  expected  to  be 
raised  by  an  attempt  to  read  one  object  as  of  the  other  type. 
However,  it  is  not  clear  exactly  how  the  Ada  standard  14.2.4:4  is  to 
be  interpreted;  thus,  this  test  objective  is  not  considered  valid 
(line  90). 

p.  CE3111C:  This  test  requires  certain  behavior,  when  two  files  are 
associated  with  the  same  external  file,  that  is  not  required  by  the 
Ada  standard. 

q.  CE3301A:  This  test  contains  several  calls  to  END_0F_LINE  and 
END_0F_PAGE  that  have  no  parameter:  these  calls  were  intended  to 
specify  a  file,  not  to  refer  to  STANDARD_INPUT  (lines  103,  107,  118, 
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WITHDRAWN  TESTS 


132,  and  136). 

r.  CE3^11B;  This  test  requires  that  a  text  file's  colaTin  number  be  set  to 
COUNT 'LAST  in  order  to  check  that  LAyOUT_ERROR  is  raised  by  a 
subsequent  PUT  operation.  But  the  former  operation  will  generally 
raise  an  exception  due  to  a  lack  of  available  disk  space,  and  the  test 
would  thus  encumber  validation  testing. 
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COMPILER  OPTIONS  AS  SUPPLIED  BY  HEWLETT  PACKARD  CO. 


Compiler:  HP  9000  Series  300  Ada  Compiler,  Version  4.35 

ACVC  Version;  1.10 


E-1 


ADA(UTJL) 


iir-ux 

ScricK  300  Only 


ADA(UT11.) 


Arguments  can  be  passed  lo  ada  through  ihc  ADaOPTS  euvirimmcnl  variairlc,  as  well  as  on  ihc 
command  line.  Ad(i(\JTlL)  pick.s  up  the  value  of  .4UAOFTS  and  places  iis  conicru.s  before  anv  nigu- 
ments  On  the  command  line.  For  example  (in  j/i^UTlL)  nolalion), 

S  ADAOPTS-’'-v  -c  10" 

S  export  ADAOPTS 
JS  ada  -L  suurcc.adu  lest  .lib 

is  equivalent  to 

S  ada  -v  -e  10  -L  suurcc.ada  tcst.lib 
Compiler  Options 

The  following  options  are  recognized: 

-H  Store  the  supplied  annotation  string  in  the  library  with  the  compilation  unit.  This 

string  can  later  be  di.splaycd  by  the  unit  manager.  The  maximum  length  of  this 
string  Ls  80  characters.  Tlie  default  is  no  siring. 

•I)  Display  abbreviated  compiler  cttoi  mcssitges  (default  is  lo  display  the  long  forms). 

-c  Suppress  link  phase,  and  if  binding  occurred,  preserve  the  object  file  produced  by 

the  buider.  This  option  only  takes  effect  if  linking  would  normally  occur.  Linking 
normally  occurs  when  binding  has  been  requested. 

U.SC  of  this  option  causes  an  informational  message  to  be  displayed  on  standard 
aror  indicating  the  format  of  the  W(UTIL)  command  used  to  link  the  program. 
The  user  may  svipply  additional  object  (.o)  and  archive  (.a)  files  and  adcliiional 
library  search  paths  (-Ir)  only  in  ihc  places  specified  by  the.  informational  message. 

When  Id  is  later  used  to  actually  link  the  program,  the  following  conciitiotts  tmisl  be 
met: 

1.  The  Ada  library  specified  when  the  bind  was  pri  formed  must  be  rc.spcci- 
fied. 

2.  I'hc  .0  file  generated  by  the  binder  must  be  spedfied  Ircforr  any  HP-UX 
archive  is  .specified  (either  c.spUdlly  or  with  -I). 

3.  If  -If  i.s  sjKcincd  wiicn  linking,  any  .u  file  containing  code  that  uses 
.tidio(LlBS)  routines  rrriisl  be  spedfied  before  -Ic  is  .specified. 

•d  Cause  the  compiler  to  stove  additional  infotinatiuri  in  the  Ada  library  for  the  uniis 

being  compiled  for  use  by  the  Ada  debugger  (.see  ada.prohc[\iT\'L)).  Only  inior- 
nialion  required  for  debugging  is  .saved;  the  source  is  not  saved.  (By  default,  debug 
iuform.iriou  is  not  stored;  .see  -D.) 

Cause  Ihc  binder  to  produce  a  debug  information  tile  for  the  ptogiain  being  bound 
so  that  the  resulting  program  can  be  manipulated  by  the  Ada  debugger.  The  debug 
information  file  name  will  be  Ihc  executable  program  file  name  with  .tut  appended. 
If  the  debug  infor  mafion  file  name  would  be  truncated  by  the  file  .system  on  which 
it  would  be  created,  an  e.rfor  will  be  rcpirricd. 

Only  sources  compiled  with  the  tl  or  -D  option  contribute  information  lo  the 
debug  infirrinatiori  file  produced  by  the  binder.  (By  default,  debug  information  file 
is  not  produced.) 

-«  <n>w>  .SlO|)  f.ompibition  after  <iinn>  errors  (legal  range  0.. 32767,  default  50). 

-•  Cause  .Illy  pending  or  existing  inslantiaiions  of  gener  ic  bodies  in  this  Ada  lilnaiy, 

whose  aciu.il  generic  bodies  have  been  compiled  or  recompiled  in  another  Ada 
library,  to  be  compiled  (or  recompiled)  in  this  Atla  lilnaiy. 
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•k 

-Iv 

•m  <itiui> 

<n 

•0  outfile 

-<I 

•r  <iwn> 

-t  c,namt 


JIP-IJX 

Series  300  Only 


ADA  (UTIL) 


This  option  is  treated  as  a  special  "source"  file  and  (he  compilation  is  pciYomicd 
when  the  option  Ls  cncnunfcrcd  among  rlic  names  of  any  actual  souice  files. 

Any  pending  or  existing  instantiations  in  the  same  Ada  libi  aiy  into  which  the  actual 
generic  body  is  compiled  (or  recompiled),  do  not  need  this  option.  Stich  pending 
or  existing  instantiations  are  automatically  compiled  (or  rccuinpileJ)  wLcii  the 
actual  generic  body  Is  compiled  into  the  same  Ada  library. 

Warning;  Compilation  (or  recumpilalioo)  of  in.stantialions  either  automalicaily  or 
by  using  this  option  uidy  affects  msuintiaiions  stored  as  .separate  units  in  (he  Ada 
library  (see  *u).  Existing  instantiations  whicli  arc  "inline"  in  another  unit  arc  not 
automatically  recompiled  not  recompiled  by  using  this  option.  Uoies  containing 
such  insiaiiliaiions  must  be  cxplieitly  recompiled  by  the  user  if  the  actual  generic 
brxly  is  recompiled. 

Cause  the  compiler  to  .save  an  internal  rc]ircscntation  of  the  source  in  tlic  Ada 
library  for  use  by  the  Ada  cros.s  rcfcrcnccr  arfe_r/-c/(UTIL),  (Ry  default,  the  inter¬ 
nal  representation  is  not  saved.) 

Cause  the  linker  to  search  the  HP-UX  librai^  named  citltcr  /lil>/iibr,a  (tried  first) 
or  /usr/llb/Iihrji  (see  W(TJTIL)). 

1'he  supplied  number  Is  the  size  in  IK  pages  to  be  a)loc.<tted  at  compile  time  to 
manipulate  library  infoonation.  The  range  is  5(X)  to  32767.  The  default  is  500. 
The  default  si^e  should  work  in  almo.sl  all  cases.  In  some  extreme  ca.ses  involving 
very  large  programs,  increasing  this  value  will  impiovc  compilation  time. 

Cause  the  output  file  from  the  linker  In  he  marked  as  .shareable  (see  -N).  For 
details  refer  to  cyi<7tr(UTIL)  and  /rf(UTIl.). 

Name  the  output  file  from  the  linker  out/i/c  instead  of  a.out.  In  addition,  name  the 
object  file  output  by  the  binder  oitifilc.o  in.Mcad  of  <u.onl>.o.  If  debitgging  is 
enabled  (with  -d  nr  -D),  name  the  dcbtig  iufoniuition  file  output  by  the  binder 
ourfiic.cai  instead  of  a.outnnii. 

The  object  file  output  by  the  bindei  is  noniicilly  deleted  following  u  sucees.sful  link 
(see  -c). 

Cause  the  output  file  from  the  linker  to  be  marked  as  demand  loadable  (.see  -O)- 
For  details  refer  to  chflfKUTlL)  and  /c/(UTlL). 

Set  listing  line  length  to  <«/m>  (legal  range  6(k.255,  default  79).  Thi.s  option 
applies  to  the  listing  produced  bv  both  the  compiler  and  (lie  binder  (sec  -f-  and 
-Wl.,-L). 

Cause  the  output  of  the  iurkcr  to  be  stripped  ot  symbol  table  infoimation  (sec 
/d(UTlL)  and  i/np(UTIL')). 

.Substitute  or  insert  subproccss  c  with  na/iie  where  c  ks  one  or  more  of  a  set  of 
idctUtfiers  indicating  the  .Nubprt»cc.s.s(c.s).  Tltis  ttpiioii  wttrks  in  two  modes:  1)  if  c  is 
a  single  idemifier,  /lanie  rcprc.sciii.s  the  full  palli  name,  of  the  new  siibpioccss;  2)  if 
c  is  a  set  of  (more  than  one)  idcntinuis,  tiunic  rr-picsents  a  prefLs  to  which  the 
standard  suffixes  ate  coiicntcnatcd  to  conMriicl  the  full  paili  name  of  the  new  suh- 
proccsscs. 

'J'hc  pos.sible  value.s  of  r  arc  the  loilowing; 

b  binder  body  (standard  suffix  is  adahind) 
c  compiler  body  (sland.sid  sulfix  is  afiocoiiijt) 
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ADA  (UTIL) 


HP-UX 
Series  300  Only 


ADA(UTIL) 


-u 


-V 


•vr 


•X 


•B 


-C 


-D 


-O 


0  Munc  as  c 

/  linker  (standard  suffix  t«  /rf) 

Cause  instantiations  of  generic  program  unit  bodies  to  be  stored  as  separate  units 
in  the  Ada  library  (sec  -i). 

If  -u  is  not  specified,  and  the  actual  generic  body  has  already  been  compiled  when 
an  liislunlialiun  of  the  body  is  armpiled,  the  body  generated  by  the  instantiation  is 
stored  "inline"  in  the  same  unit  us  iu  declaration. 

If  -u  is  specified,  or  the  actual  generic  body  has  not  already  been  compiled  when  an 
instantiation  of  the  body  Ls  compiled,  the  body  generated  by  the  ijvstantiation  is 
stored  as  a  separate  unit  >n  the  Ada  library. 

Tire  -u  option  may  be  needed  if  a  large  number  of  generic  instantiations  within  a 
given  unit  result  in  the  overflow  of  a  uunpilcr  internal  table. 

Specifying  -ii  reduces  the  amount  of  table  space  needed,  permitting  the  compiler  to 
complete.  However  it  alsii  increases  the  numlxrr  of  units  u.scd  within  the  Ada 
library,  ns  well  as  introduce  a  smalt  amount  of  overhead  at  execution  time,  iir  units 
whicli  instantiate  generics. 

Hnable  vcrbo.se  mode,  producing  a  .step-by-step  dc.scriprion  of  the  comfrilation, 
binding,  and  linking  process  on  standard  error. 

iiuppress  warning  nic.ssages. 

Perform  syntactic  checking  only.  Tire  Hhraryname.  argument  inu.<;(  he  .supplied, 
although  the  Ada  library  Is  not  modified. 

Cause  the  compiler  to  suppres.s  page  bc.sders  and  the  error  summary  at  the  end  of 
the  compilation  listing.  Tills  Is  useful  when  comparing  a  compilation  listing  with  a 
previous  compilation  listing  of  (lie  same  program,  witlioiil  llic  page  lieailers  cau.sing 
inismaiclies.  This  option  can  not  be  .specified  in  conjunclion  ihe  -L  opiion. 

.Suppress  runtime  checks.  Use  of  this  option  may  result  in  erroneous  (in  the  Ada 
sense)  program  behavior.  In  addition,  some  cliccks  (such  as  those  auiomaiic.nlly 
provitied  by  hardware)  might  not  be  suppressed. 

C.nisc  the  compiler  to  store  additional  informaliun  in  the  Ada  library  for  the  units 
being  euinjhled,  for  use  iry  the  Ada  debugger  (see  «t/t;.wr)0fr(L’TIL)).  In  addition 
U)  saving  information  required  for  debugging,  ,in  Internal  icpicsentation  of  tite 
actual  source  is  saved.  This  permits  accurate  source  level  debugging  at  the  expense 
of  .1  large.r  Ada  library  if  the  actual  .stiurcc  file  changes  after  it  is  compiled.  (Dv 
defimll,  neither  debug  information  nor  sotircc  information  is  stored;  see.  -d). 

Cause  the  binder  to  produce  a  debug  information  file  for  the  piogram  being  bound 
so  that  the  resulting  program  can  be  manipulated  by  the  Ada  delniggei.  The  debug 
information  file  name  is  the  executable  program  file  name  with  .cui  afipcndcd.  If 
the  debug  information  file  name  would  be  truncated  by  the  file  system  on  which  it 
would  be  cjcaled,  an  eritrr  will  be  reported. 

Only  sources  compiled  with  the  -d  or  -0  option  contiibtitc  Infointnlion  to  (he 
debug  information  (ilc  produced  by  the  biuder  (Hy  default,  the  debtig  infoinialioii 
file  is  not  produced.) 

Generate  code  but  do  nor  upd.-nc  the  libiaiy.  This  is  jiiimatily  liucitdcd  to  allow 
one  to  get  an  a.sseinbly  listing  (wIili  -.S)  withotit  changing  the.  libiaiy.  The.  libnir- 
ynantf!  argument  mnsi  bo.  supplhtd,  allliotigh  llic  Ada  libra/ y  is  not  nuidificd. 
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•1 

-L 

-M  <main> 


-N 

•O 

-P 

-0 

•s 

•W  c,ar^I[,ai^2,. 


iir-ux 

Scric*  300  Only 


ADA(UnL) 


Suppress  all  inliniug.  No  procedures  or  functions  are  expanded  inline  and  pr  numn . 
inline  is  ignored.  This  also  prcvcnis  units  compiled  in  the  future  (without  this 
Option  in  effect)  from  inlining  any  units  armpilcd  with  this  option  in  effect. 

’Write  a  program  listing  with  error  diagnostics  to  .standard  output.  This  option  can 
not  be  .specified  in  conjunction  with  the  -B  option. 

Invoke  the  binder  after  all  soutcc  files  nanted  in  tire  coininand  line  (if  any)  have 
been  .successfully  compiled.  The  argument  <nuiin>  spceifics  the  entry  point  of 
the  Avia  program;  <iuuin>  must  Ire  the  name  of  a  parante(erle.S5  Ada  library  level 
procedure. 

The  library  level  procedure  <mflMr>  must  have  been  succcs.sfully  compiled  info 
(or  linked  iruo)  the  named  Ada  library,  either  by  this  invocation  of  ada  or  by  a  prc> 
vious  invocation  of  ada  (or  ada.uinsr(lJT]lJ)). 

The  binder  produces  an  objea  file  named  <a.out>  .o  (unless  -o  is  used  to  specify 
an  alternate  nante),  which  is  noriitally  deleted  if  the  link  phase  is  successful  (see 
•c).  Note  that  the  alternate  name  is  Iruncalcd,  if  ncec.s.sary,  prior  to  appending  .ii. 

Cause  (he  output  file  from  the  linker  to  be  marked  as  un.shurcablc  (see  -n).  For 
details  refer  to  c/itftr(UTlL)  and  /d(UTlL). 

Invoke  the  optimizer.  This  is  equivalent  to  +0  eio. 

Set  testing  page  length  to  <ntm>  lines  (legal  range  l.221Cn  or  0  to  indicate  no 
page  breaks,  default  66).  This  Icngdi  is  the  total  number  of  lines  listed  per  iisiing 
page,  it  includes  the  beading,  header  and  trailer  blank  line.s,  lisicd  program  lines, 
and  error  message  lines.  Some  pages  might  be  .shorre.r  tlian  specified,  .since  .some 
mullMinc  messages  arc  moved  to  a  new  page  rather  than  split  across  a  page  bouu- 
dai7.  This  option  applies  to  the  listing  produced  by  both  the  compiler  and  the 
binder  (sec  ‘L  and  -W  b,*L). 

Csusc  the  ouipiu  file  from  the  linker  to  he  marked  as  not  demand  loadable  (.see 
-q).  For  details  refer  to  c^nrofUTlL)  and  /d(IlTlL). 

Write  an  assembly  listing  of  the  code  gcncr.sicd  to  si.indard  ouipui.  This  output  is 
not  in  a  form  .suitable  for  procc.ssing  witlt  «(UTIJ.). 

..,argNJ 

Cause  «rgi  through  ai^N  to  be  handed  off  to  snbproccss  i\  The  atj'i  arc  of  the 
form  -ar^nption f.afj^aiuirj,  where  ai^opiion  is  the  name  of  an  option  iccognirevi  by 
the  .subprnccss  and  ar^valuc  is  a  separate  urgumeni  to  uiyapiion  where  necessary. 
The  values  that  c  can  assume  arc  lho.se  listed  under  the  •(  option  a.s  wcil  as  d 
(driver  program). 

For  example,  the  specification  to  pass  the  -r  (picscivc  iclocalion  information) 
option  to  the  linker  would  be: 

-W  1,-r 

For  cx.nmp]e,  tite  following: 

-W 

.sends  the  options  -m  10  -s  2  to  the  binder.  Note  that  all  the  binder  options  can  be 
supplied  with  one  -W,  (more  than  one  -W  can  also  be  used)  and  that  any  embed¬ 
ded  sp.sccs  must  be  rcpia<.«d  with  comma-s.  Note  that  -VV  b  is  the  only  way  to 
.specify  binder  options. 
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The  -W  d  option  specincolion  allows  addiiional  implcmcnUlion-spexific  ojitinns  to 
be  rccognKcd  and  passed  ibrougli  ll>c  compllci  dilvcr  to  the  approprlute  subpro¬ 
cess.  For  example, 

-W  d,-0,eA 

send.s  the  ojjtiuu  -O  cti  to  the  diWe;,  which  sends  it  to  the  compiler  so  that  the.  e 
and  0  optimi/Jtl.ion.s  are  performed.  Furtheniiore,  ii  shorthand  notation  for  this 
mecJianism  can  be  used  by  prepending  the  option  with  +;  as  follows: 

+  0  CO 

This  is  equivalcnl  to  -W  d,-0,eo.  Note  Uiat  for  simplicity  this  shorthand  is  applied 
to  each  tiupletncntation-spcciric  option  individually,  and  that  llte  ar^valiie  (if  any)  is 
.separated  from  the  shorthand  ur^pfhn  with  while  s|>acc  instead  of  a  comma. 

-X  I’crform  syntactic  and  semantic  checking.  The  lihraryname  argument  must  I'te  .sup 

plied,  althungli  iJie  Ada  library  is  net  modified. 

Binder  Options 

Tlie  following  options  can  be  passed  to  the  binder  u.sing  -W 

-W  b,-b  At  cxcailion  time,  interactive  input  blocks  if  data  is  uot  available.  All  ta.sk.s  arc 

suspended  if  input  data  Is  «»ot  available.  Tliis  option  Ls  the  default  if  the  jrrogrant 
ermtains  no  tasks  (sec  -W  b,-U). 

-W  b,-k  Keep  unciillcd  subprograms  when  binding.  The  default  is  to  remove  them. 

•W  b,-in,<min>  Set  the  iuitiul  progtam  Stack  si7.c.  to  <tmn>  units  of  1024  bytes  (legal  range 
1.-32767,  default  10  units  -  10  *  1024  bytes  “  1024<1  bytes).  The  value  is  roundcil 
up  to  the  next  multiple  of  2. 

•W  b,-s, <«/»!>  Cause  round-robin  scheduling  to  be  used  for  ta.sking  programs.  Set  the  time  .slice 
to  </]W]>  terns  of  milli.second.s  (legal  range  1.. 32767  or  0  to  turn  off  time  sliut)g). 
By  default,  rtjund-robin  .scheduling  is  enabled  will)  a  rime  .slice  of  1  .second 
100). 

The  time  .slice  granularity  i.s  20  millLseconds  (<nrnt>  =  2). 

•W  .Set  ta.sk  .stack  .size  of  created  laak.s  to  <nnn>  units  of  1024  byic.s. 

Set  the  iriiiiid  (and  uiaMinum)  task  stack  sire  (lcg.'»l  range  1..327fi7,  defauil  S  units 
•=  8  *  1024  byic.s  -  8192  byic.s). 

•\V  b,-w  .Suppress  warning  mc.ssages, 

•W  b,-x  Perform  eoiisistcney  eliceks  without  producing  an  object  file  and  .suppress  linking. 

The  -W  b,'L  ttplitm  enij  be  used  to  obtain  biudci  listing  information  when  this 
opt  ion  i.s  .specified  (.see  -W  b,-L  beiow). 

•W  b,-I5  At  exeeuiiuii  time,  iiileiactivc  input  does  not  block  if  data  is  not  available.  Only 

the  la.sk(.s)  doing  inieraaive  input  are  suspended  if  input  data  is  not  aveuiabic.  I'liis 
option  is  the  default  if  the  program  contains  I'-sks  (see  -W  b,-b). 

'W  b,-L  Write  a  binder  lislitig  with  wuming/ciroi  diagnostics  to  .standard  output.  .Severe 

errors  arc  listed  to  slumiiird  error. 

•W  b,-T  .$upprc,s.s  procedure  traceback  in  rc.spon.se  to  runtime  errors  fln«l  unhandlcd  cxccp 

tions. 


Locks 

To  ensiiic  the  iiKCgiity  of  thcii  internal  dat,”*  strucniics,  Ada  libiarics  and  families  are  locked  for  the 
duiation  of  opciaiions  that  aic  pcifotmc-d  on  them.  Normally  Ada  families  iire  locked  lot  only  a 
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